Método IMediaControl::Stop (control.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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.]
O Stop método interrompe todos os filtros no grafo.
Sintaxe
HRESULT Stop();
Retornar valor
Retorna S_OK se tiver êxito ou um valor HRESULT que indica a causa do erro.
Comentários
Se o grafo estiver em execução, esse método pausará o grafo antes de pará-lo. Enquanto pausados, os renderizadores de vídeo podem copiar o quadro atual para exibir como um quadro de pôster.
Esse método não busca o início do fluxo. Se você chamar esse método e chamar o método IMediaControl::Run , a reprodução será retomada da posição interrompida. Para buscar, use a interface IMediaSeeking .
O Gerenciador de Grafo de Filtro pausa todos os filtros no grafo e, em seguida, chama o método IMediaFilter::Stop em todos os filtros, sem aguardar a conclusão das operações de pausa. Portanto, alguns filtros podem ter seu Stop método chamado antes de concluirem a operação de pausa. Se você desenvolver um filtro de renderização personalizado, talvez seja necessário lidar com esse caso pausando o filtro se ele receber um comando stop enquanto estiver em execução. No entanto, a maioria dos filtros não precisa tomar nenhuma ação especial nesse sentido.
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) |
| Biblioteca | Strmiids.lib |