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 |
|---|---|
|
Der Übergang ist nicht abgeschlossen. |
|
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 |