Método IMediaControl::P ause (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 Pause método pausa todos os filtros no grafo de filtro.

Sintaxe

HRESULT Pause();

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Comentários

Pausar o grafo de filtro indica o grafo para renderização imediata quando o grafo for executado na próxima execução. Enquanto o grafo está em pausa, os filtros processam dados, mas não os renderizam. Os dados são enviados por push pelo grafo e processados por filtros de transformação no que diz respeito às permissões de buffer, mas os filtros de renderizador não renderizam os dados. No entanto, os renderizadores de vídeo exibem um quadro de pôster estático do primeiro exemplo.

Se o método retornar S_FALSE, chame o método IMediaControl::GetState para aguardar a conclusão da transição de estado ou marcar se a transição tiver sido concluída. Quando você chama Pause para exibir o primeiro quadro de um arquivo de vídeo, siga-o imediatamente com uma chamada para GetState para garantir que a transição de estado tenha sido concluída. A falha em fazer isso pode fazer com que o retângulo de vídeo seja pintado de preto.

Se o método falhar, ele interromperá o grafo antes de retornar.

Requisitos

Confira também

Códigos de erro e êxito

IMediaControl Interface

IMediaControl::StopWhenReady