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 |