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 |
|