Compartilhar via

Método IMediaEvent::WaitForCompletion (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 WaitForCompletion método aguarda o grafo de filtro renderizar todos os dados disponíveis. O grafo de filtro deve estar em execução ou o método falhará.

Sintaxe

HRESULT WaitForCompletion(
  [in]  long msTimeout,
  [out] long *pEvCode
);

Parâmetros

[in] msTimeout

Intervalo de tempo limite, em milissegundos. Passe zero para retornar imediatamente. Passe o valor INFINITE para bloquear indefinidamente.

[out] pEvCode

Ponteiro para uma variável que recebe um código de evento. Confira Comentários para obter mais informações.

Retornar valor

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

Código de retorno Descrição
S_OK
 Êxito.
E_ABORT
 O tempo limite expirou.
VFW_E_WRONG_STATE
 O grafo de filtro não está em execução.

Comentários

Esse método bloqueia até que o tempo limite expire ou um dos seguintes eventos ocorra:

Durante a espera, o método descarta todas as outras notificações de evento.

Se o valor retornado for S_OK, o parâmetro pEvCode receberá o código de evento que encerrou a espera. Quando o método retorna, o grafo de filtro ainda está em execução. O aplicativo pode pausar ou parar o grafo, conforme apropriado.

Requisitos

   
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

IMediaEvent Interface