Método IMediaControl::Stop (control.h)

  • Artigo

[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

Confira também

Códigos de erro e êxito

IMediaControl Interface

StopWhenReady