IMediaEventEx::GetNotifyFlags-Methode (control.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die GetNotifyFlags -Methode bestimmt, ob Ereignisbenachrichtigungen aktiviert sind.

Syntax

HRESULT GetNotifyFlags(
  [out] long *lplNoNotifyFlags
);

Parameter

[out] lplNoNotifyFlags

Zeiger auf eine Variable, die einen der folgenden Werte empfängt:

Wert	BESCHREIBUNG
Null	Ereignisbenachrichtigungen sind aktiviert.
AM_MEDIAEVENT_NONOTIFY	Ereignisbenachrichtigungen sind deaktiviert.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder E_POINTER zurück, wenn der lplNoNotifyFlags-ParameterNULL ist.

Hinweise

Standardmäßig stellt der Graph-Filter-Manager Ereignisbenachrichtigungen für die Anwendung bereit. Um die Ereignisbenachrichtigung zu deaktivieren, rufen Sie die IMediaEventEx::SetNotifyFlags-Methode mit dem Wert AM_MEDIAEVENT_NONOTIFY auf.

Wenn Ereignisbenachrichtigungen deaktiviert sind, wird das von der IMediaEvent::GetEventHandle-Methode zurückgegebene Handle am Ende jedes Datenstroms signalisiert, d. h. immer dann, wenn der Filter Graph-Manager ein EC_COMPLETE-Ereignis empfängt.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

Fehler- und Erfolgscodes

IMediaEventEx-Schnittstelle