Método IMediaControl::P ause (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 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.

Código de retorno Descrição
S_FALSE
 O grafo fez uma pausa com êxito, mas alguns filtros não concluíram a transição de estado.
S_OK
 Todos os filtros no grafo concluíram a transição para um estado em pausa.

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

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

IMediaControl::StopWhenReady