CBaseFilter.NotifyEvent-Methode

Artikel
07/28/2023

[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 NotifyEvent -Methode sendet eine Ereignisbenachrichtigung an den Filtergraph-Manager.

Syntax

HRESULT NotifyEvent(
   long     EventCode,
   LONG_PTR EventParam1,
   LONG_PTR EventParam2
);

Parameter

EventCode: Ereignisbenachrichtigungscode.
EventParam1: Erster Parameter des Ereignisses.
EventParam2: Zweiter Parameter des Ereignisses.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die werte in der folgenden Tabelle.

Rückgabecode	Beschreibung
S_FALSE	Der Filtergraph-Manager akzeptiert keine Ereignisbenachrichtigungen.
S_OK	Erfolg.
E_NOTIMPL	Filter verfügt nicht über einen Zeiger auf die IMediaEventSink-Schnittstelle .

Bemerkungen

Eine Liste der Benachrichtigungscodes und Parameterwerte finden Sie unter Ereignisbenachrichtigungscodes.

Wenn der Ereigniscode in der Basisklasse EC_COMPLETE ist, legt die Methode den EventParam2-Parameter auf einen Zeiger auf die IBaseFilter-Schnittstelle des Filters fest.

Anforderungen

Anforderung	Wert
Header	Amfilter.h (streams.h einschließen)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseFilter-Klasse

Freigeben über