WaitDispatchingMessages-Funktion
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die WaitDispatchingMessages Funktion wartet, bis ein Objekt signalisiert wird, während Fenstermeldungen gesendet werden.
Syntax
DWORD WINAPI WaitDispatchingMessages(
HANDLE hObject,
DWORD dwWait,
HWND hwnd = NULL,
UINT uMsg = 0,
HANDLE hEvent = NULL
);
Parameter
-
hObject
-
Handle des Objekts, auf das gewartet werden soll.
-
dwWait
-
Timeoutintervall in Millisekunden.
-
hwnd
-
Optionales Handle für ein Fenster.
-
uMsg
-
Optionale Fensternachricht, die eine zu sendende Nachricht angibt.
-
hEvent
-
Optionales Handle für ein Ereignis, auf das gewartet werden soll.
Rückgabewert
Gibt den Wert aus der WaitForMultipleObjects-Funktion zurück.
Bemerkungen
Wenn ein Objekt im Besitz eines Fensters ist, sollte es während des Wartens Fenstermeldungen senden. Mit dieser Funktion kann das Objekt beim Senden von Nachrichten auf ein Ereignis, ein Semaphor oder ein anderes Objekt für gegenseitigen Ausschluss warten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch