IPin::EndOfStream-Methode (strmif.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 EndOfStream -Methode benachrichtigt den Pin, dass keine zusätzlichen Daten erwartet werden, bis ein neuer Ausführungsbefehl für den Filter ausgegeben wird.

Anwendungen sollten diese Methode nicht aufrufen. Diese Methode wird von anderen Filtern aufgerufen, um das Ende des Datenstroms zu signalisieren.

Syntax

HRESULT EndOfStream();

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_UNEXPECTED	Der Pin ist ein Ausgabepin.

Hinweise

Rufen Sie diese Methode nur bei Eingabenadeln auf. Ausgabepins geben E_UNEXPECTED zurück.

Diese Methode sendet eine Benachrichtigung zum Streamende an die Pin. Der Pin übermittelt die Benachrichtigung nachgeschaltet. Sie muss Benachrichtigungen zum Datenstromende mit IMemInputPin::Receive-Anrufen serialisieren. Wenn die Pin Medienbeispiele für die Übermittlung in die Warteschlange stellt, sollte sie auch Benachrichtigungen zum Streamende in die Warteschlange stellen. Die IPin::BeginFlush-Methode leert alle Benachrichtigungen zum Ende des Datenstroms in der Warteschlange.

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	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Datenfluss im Filtergraphen

Fehler- und Erfolgscodes

IPin-Schnittstelle