Help Center

CDSAudio.Pausemethod

Pauses all the filters in the filter graph.

AudiomethodCDSAudio.incdocumented

Syntax

FUNCTION Pause () AS HRESULT

Description

Pauses all the filters in the filter graph.

Remarks

Pausing the filter graph cues the graph for immediate rendering when the graph is next run. While the graph is paused, filters process data but do not render it. Data is pushed through the graph and processed by transform filters as far as buffering permits, but renderer filters do not render the data. However, video renderers display a static poster frame of the first sample.

If the method returns S_FALSE, call the GetState method to wait for the state transition to complete, or to check if the transition has completed. When you call Pause to display the first frame of a video file, always follow it immediately with a call to GetState to ensure that the state transition has completed. Failure to do this can result in the video rectangle being painted black.

If the method fails, it stops the graph before returning.

Reference

  • Include file CDSAudio.inc
  • Defined in AfxNova/CDSAudio.inc:182
  • Documented in Audio/CDSAudio Class.md
  • Topic: CDSAudio Class