IMediaEventEx::SetNotifyWindow-Methode (control.h)
[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 SetNotifyWindow -Methode registriert ein Fenster zum Verarbeiten von Ereignisbenachrichtigungen.
Syntax
HRESULT SetNotifyWindow(
[in] OAHWND hwnd,
[in] long lMsg,
[in] LONG_PTR lInstanceData
);
Parameter
[in] hwnd
Handle an das Fenster oder NULL , um den Empfang von Ereignismeldungen zu beenden.
[in] lMsg
Fenstermeldung, die als Benachrichtigung übergeben werden soll.
[in] lInstanceData
Der Wert, der als lParam-Parameter für die lMsg-Nachricht übergeben werden soll.
Rückgabewert
Gibt S_OK zurück, wenn erfolgreich oder E_INVALIDARG, wenn der hwnd-Parameter kein gültiges Handle für ein Fenster ist.
Bemerkungen
Diese Methode legt ein Fenster fest, in dem Ereignisbenachrichtigungen verarbeitet werden. Wenn der Filter Graph-Manager ein Ereignis in die Ereigniswarteschlange einfügt, wird auch eine Nachricht im angegebenen Fenster gesendet. Der Parameter hwnd gibt das Fenster an, und der Parameter lMsg gibt die Meldung an. Die Anwendung sollte zu diesem Zweck eine private Fenstermeldung definieren. Der lParam-Parameter der Nachricht wird auf den Wert von lInstanceData und der wParam-Parameter auf Null festgelegt.
Wenn das Fenster die Nachricht empfängt, sollte es die IMediaEvent::GetEvent-Methode aufrufen, um das Ereignis abzurufen. Ereignisse sind asynchron, sodass die Warteschlange mehrere Ereignisse (oder keine) enthalten kann. Rufen Sie GetEvent wiederholt auf, bis ein Fehlercode zurückgegeben wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | control.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |