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