IMediaEventEx::SetNotifyFlags-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 SetNotifyFlags -Methode aktiviert oder deaktiviert Ereignisbenachrichtigungen.

Syntax

HRESULT SetNotifyFlags(
  [in] long lNoNotifyFlags
);

Parameter

[in] lNoNotifyFlags

Wert, der angibt, ob Ereignisbenachrichtigungen aktiviert oder deaktiviert werden sollen. Dies muss einer der folgenden Werte sein:

Wert	BESCHREIBUNG
Null	Aktivieren Sie Ereignisbenachrichtigungen.
AM_MEDIAEVENT_NONOTIFY	Deaktivieren Sie Ereignisbenachrichtigungen.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder E_INVALIDARG zurück, wenn der lNoNotifyFlags-Parameter ungültig ist.

Hinweise

Standardmäßig stellt der Graph-Filter-Manager Ereignisbenachrichtigungen für die Anwendung bereit. Wenn der lNoNotifyFlags-Parameter AM_MEDIAEVENT_NONOTIFY ist, löscht der Filter Graph Manager alle ausstehenden Ereignisbenachrichtigungen aus der Warteschlange und postet keine neuen Ereignisbenachrichtigungen.

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