Funzione WaitDispatchingMessages

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

La WaitDispatchingMessages funzione attende che un oggetto venga segnalato, durante l'invio dei messaggi della finestra.

Sintassi

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

Parametri

hObject

Handle dell'oggetto da attendere.

dwWait

Intervallo di timeout, espresso in millisecondi.

Hwnd

Handle facoltativo in una finestra.

Umsg

Messaggio di finestra facoltativo, che specifica un messaggio da inviare.

hEvent

Handle facoltativo per un evento da attendere.

Valore restituito

Restituisce il valore della funzione WaitForMultipleObjects .

Commenti

Se un oggetto è proprietario di una finestra, deve inviare messaggi finestra durante l'attesa. Questa funzione consente all'oggetto di attendere un evento, un semaforo o un altro oggetto di esclusione reciproca durante l'invio dei messaggi.

Requisiti

Requisito	Valore
Intestazione	Wxutil.h (include Streams.h)
Libreria	Strmbase.lib (build retail); Strmbasd.lib (build di debug)

Vedi anche

Varie funzioni helper