CBaseFilter.NotifyEvent-Methode

  • Artikel

[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