IMediaFilter::Stop-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 Stop -Methode beendet den Filter.

Syntax

HRESULT Stop();

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die in der folgenden Tabelle gezeigten Werte.

Rückgabecode	Beschreibung
S_FALSE	Der Übergang ist nicht abgeschlossen.
S_OK	Erfolg. Der Übergang ist abgeschlossen.

Bemerkungen

Wenn ein Filter beendet wird, werden keine Proben verarbeitet oder übermittelt, und er lehnt Proben aus Upstream Filtern ab.

Der Zustandsübergang kann asynchron sein. Wenn die Methode zurückgibt, bevor der Übergang abgeschlossen ist, wird der Rückgabewert S_FALSE.

Diese Methode legt den Status des Filters immer auf State_Stopped fest, auch wenn die Methode einen Fehlercode zurückgibt.

Anforderungen

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

Siehe auch

Fehler- und Erfolgscodes

FILTER_STATE-Enumeration

IMediaFilter-Schnittstelle