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

Siehe auch

Fehler- und Erfolgscodes

IMediaEventEx-Schnittstelle