CBasePin.Inactive-Methode

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die Inactive -Methode benachrichtigt den Pin, dass der Filter nicht mehr aktiv ist.

Syntax

virtual HRESULT Inactive();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Wenn der Filter beendet wird, ruft die CBaseFilter-Klasse diese Methode für alle verbundenen Pins des Filters auf.

Diese Methode führt in der Basisklasse nichts aus. Abgeleitete Klassen sollten diese Methode überschreiben, um alle Ressourcen freizugeben, die von der CBasePin::Active-Methode abgerufen wurden. beispielsweise, um die Zuordnungen des Pins zu deaktivieren.

Der interne Zustand des Filterdiagramm-Managers wird erst aktualisiert, nachdem diese Methode zurückgegeben wurde. Testen Sie also nicht den Zustand dieser Methode.

Anforderungen

Anforderung Wert
Header
Amfilter.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBasePin-Klasse