Freigeben über


CBaseFilter.Stop-Methode

[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. Diese Methode implementiert die IMediaFilter::Stop-Methode .

Syntax

HRESULT Stop();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder einen HRESULT-Wert zurück, der die Fehlerursache angibt.

Bemerkungen

Diese Methode ruft die CBasePin::Inactive-Methode für jeden der verbundenen Pins des Filters auf. Außerdem wird der Status des Filters auf State_Stopped festgelegt.

Wenn der Filter beendet wird, sollte er Beispiele aus Upstream ablehnen, die Nachschaltung von Beispielen beenden, Workerthreads herunterfahren und alle Ressourcen freigeben, die er für das Streaming verwendet hat.

Anforderungen

Anforderung Wert
Header
Amfilter.h (streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseFilter-Klasse