Interface IMediaControl (control.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
A IMediaControl interface fornece métodos para controlar o fluxo de dados por meio do grafo de filtro. Ele inclui métodos para executar, pausar e parar o grafo. O Gerenciador de Grafo de Filtro implementa essa interface. Para obter mais informações sobre estados de grafo de filtro, consulte Fluxo de Dados no Grafo de Filtro.
Herança
A interface IMediaControl herda da interface IDispatch . IMediaControl também tem estes tipos de membros:
Métodos
A interface IMediaControl tem esses métodos.
| IMediaControl::AddSourceFilter O método AddSourceFilter adiciona um filtro de origem ao grafo de filtro. |
| IMediaControl::get_FilterCollection O método get_FilterCollection recupera uma coleção dos filtros no grafo de filtro. |
| IMediaControl::get_RegFilterCollection O método get_RegFilterCollection recupera uma coleção de todos os filtros listados no registro. |
| IMediaControl::GetState O método GetState recupera o estado do grafo de filtro pausado, em execução ou parado. |
| IMediaControl::P ause O método Pause pausa todos os filtros no grafo de filtro. |
| IMediaControl::RenderFile O método RenderFile cria um grafo de filtro que renderiza o arquivo especificado. (IMediaControl.RenderFile) |
| IMediaControl::Run O método Run executa todos os filtros no grafo de filtro. Enquanto o grafo está em execução, os dados se movem pelo grafo e são renderizados. |
| IMediaControl::Stop O método Stop interrompe todos os filtros no grafo. |
| IMediaControl::StopWhenReady O método StopWhenReady pausa o grafo de filtro, permitindo que os filtros enfileiram dados e, em seguida, interrompe o grafo de filtro. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | control.h (inclua Dshow.h) |