IMediaEvent-Schnittstelle (control.h)

[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 IMediaEvent Schnittstelle enthält Methoden zum Abrufen von Ereignisbenachrichtigungen und zum Überschreiben der Standardbehandlung von Ereignissen im Filter Graph-Manager. Die IMediaEventEx-Schnittstelle erbt diese Schnittstelle und erweitert sie.

Der Filter Graph-Manager implementiert diese Schnittstelle. Anwendungen können sie verwenden, um auf Ereignisse zu reagieren, die im Filterdiagramm auftreten, z. B. das Ende eines Datenstroms oder einen Renderingfehler. Filtert Postereignisse im Filterdiagramm mithilfe der IMediaEventSink-Schnittstelle .

Weitere Informationen zu Ereignisbenachrichtigungen finden Sie unter Ereignisbenachrichtigung in DirectShow. Eine Liste der systemdefinierten Ereignisbenachrichtigungen finden Sie unter Ereignisbenachrichtigungscodes.

Vererbung

Die IMediaEvent-Schnittstelle erbt von der IDispatch-Schnittstelle . IMediaEvent verfügt auch über folgende Arten von Membern:

Methoden

Die IMediaEvent-Schnittstelle verfügt über diese Methoden.

IMediaEvent::CancelDefaultHandling Die CancelDefaultHandling-Methode bricht die Standardbehandlung des Filter Graph-Managers für ein angegebenes Ereignis ab. Die Ereignisbenachrichtigung wird an die Anwendung übergeben.
IMediaEvent::FreeEventParams Die FreeEventParams-Methode gibt Ressourcen frei, die den Parametern eines Ereignisses zugeordnet sind.
IMediaEvent::GetEvent Die GetEvent-Methode ruft die nächste Ereignisbenachrichtigung aus der Ereigniswarteschlange ab.
IMediaEvent::GetEventHandle Die GetEventHandle-Methode ruft ein Handle für ein Ereignis mit manueller Zurücksetzung ab, das signalisiert bleibt, während die Warteschlange Ereignisbenachrichtigungen enthält.
IMediaEvent::RestoreDefaultHandling Die RestoreDefaultHandling-Methode stellt die Standardbehandlung des Filter Graph-Managers für ein angegebenes Ereignis wieder her.
IMediaEvent::WaitForCompletion Die WaitForCompletion-Methode wartet darauf, dass das Filterdiagramm alle verfügbaren Daten rendert. Das Filterdiagramm muss ausgeführt werden, andernfalls schlägt die Methode fehl.

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)

Weitere Informationen

IDispatch