Função WaitDispatchingMessages

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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.]

A WaitDispatchingMessages função aguarda que um objeto seja sinalizado durante a expedição de mensagens de janela.

Sintaxe

DWORD WINAPI WaitDispatchingMessages(
   HANDLE hObject,
   DWORD  dwWait,
   HWND   hwnd = NULL,
   UINT   uMsg = 0,
   HANDLE hEvent = NULL
);

Parâmetros

hObject

Identificador do objeto pelo qual aguardar.

dwWait

Intervalo de tempo limite, em milissegundos.

hwnd

Identificador opcional para uma janela.

uMsg

Mensagem de janela opcional, especificando uma mensagem para expedir.

hEvent

Identificador opcional para um evento a aguardar.

Retornar valor

Retorna o valor da função WaitForMultipleObjects .

Comentários

Se um objeto possuir uma janela, ele deverá expedir mensagens de janela enquanto aguarda. Essa função permite que o objeto aguarde um evento, semáforo ou outro objeto de exclusão mútua durante a expedição de mensagens.

Requisitos

Requisito	Valor
parâmetro	Wxutil.h (inclua Streams.h)
Biblioteca	Strmbase.lib (builds de varejo); Strmbasd.lib (builds de depuração)

Confira também

Funções auxiliares diversas