Freigeben über


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