IMediaControl interface (control.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The IMediaControl interface provides methods for controlling the flow of data through the filter graph. It includes methods for running, pausing, and stopping the graph. The Filter Graph Manager implements this interface. For more information on filter graph states, see Data Flow in the Filter Graph.

Inheritance

The IMediaControl interface inherits from the IDispatch interface. IMediaControl also has these types of members:

Methods

The IMediaControl interface has these methods.

 
IMediaControl::AddSourceFilter

The AddSourceFilter method adds a source filter to the filter graph.
IMediaControl::get_FilterCollection

The get_FilterCollection method retrieves a collection of the filters in the filter graph.
IMediaControl::get_RegFilterCollection

The get_RegFilterCollection method retrieves a collection of all the filters listed in the registry.
IMediaControl::GetState

The GetState method retrieves the state of the filter graph�paused, running, or stopped.
IMediaControl::Pause

The Pause method pauses all the filters in the filter graph.
IMediaControl::RenderFile

The RenderFile method builds a filter graph that renders the specified file. (IMediaControl.RenderFile)
IMediaControl::Run

The Run method runs all the filters in the filter graph. While the graph is running, data moves through the graph and is rendered.
IMediaControl::Stop

The Stop method stops all the filters in the graph.
IMediaControl::StopWhenReady

The StopWhenReady method pauses the filter graph, allowing filters to queue data, and then stops the filter graph.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header control.h (include Dshow.h)

See also

IDispatch