Método IMediaEvent::WaitForCompletion (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 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 |
|---|---|
|
Êxito. |
|
O tempo limite expirou. |
|
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 |