Freigeben über


EC_COMPLETE

[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.]

Alle Daten aus einem bestimmten Stream wurden gerendert.

Parameter

lParam1

(HRESULT) Status des Streams nach Abschluss. Wenn während der Wiedergabe keine Fehler aufgetreten sind, wird der Wert S_OK.

lParam2

(IUnknown*) Null oder ein Zeiger auf die IBaseFilter-Schnittstelle des Renderers.

Standardaktion

Standardmäßig leitet der Filterdiagramm-Manager dieses Ereignis nicht an die Anwendung weiter. Nachdem jedoch alle Datenströme im Graphbericht EC_COMPLETE, sendet der Filterdiagramm-Manager ein separates EC_COMPLETE Ereignis an die Anwendung.

Wenn die Standardaktion für dieses Ereignis deaktiviert ist, empfängt die Anwendung alle EC_COMPLETE Ereignisse von den Renderern.

Bemerkungen

Ein Rendererfilter sendet dieses Ereignis, wenn er eine Benachrichtigung zum Ende des Datenstroms empfängt. (Das Ende des Datenstroms wird über die IPin::EndOfStream-Methode signalisiert.) Der Filter sendet genau ein EC_COMPLETE Ereignis für jeden Stream. Der Filter muss alle ausstehenden Beispiele verarbeiten, bevor er das Ereignis sendet. Das Beenden eines Renderers setzt alle zwischengespeicherten End-of-Stream-Status zurück.

Wenn der Renderer angehalten wird, sendet er erst EC_COMPLETE , wenn die IMediaFilter::Run-Methode aufgerufen wird. Darüber hinaus werden weiterhin EC_COMPLETE Ereignisse für jeden Übergang von der Pause zur Ausführung gesendet, bis der Filter entweder beendet oder geleert wird.

Filter legen den lParam2-Parameter auf einen IBaseFilter-Zeiger fest. Wenn die Standardaktion aktiviert ist, legt der Filterdiagramm-Manager diesen Parameter auf 0 fest.

Anforderungen

Anforderung Wert
Header
Dshow.h

Siehe auch

Ereignisbenachrichtigungscodes

Ereignisbenachrichtigung in DirectShow

Alternative Videorenderer