Share via


CDynamicOutputPin.Active-Methode

[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 Active -Methode benachrichtigt den Pin, dass der Filter jetzt aktiv ist.

Syntax

HRESULT Active();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

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

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_FAIL
Fehler. CDynamicOutputPin::SetConfigInfo wurde nicht aufgerufen.

Bemerkungen

Diese Methode überschreibt die CBaseOutputPin::Active-Methode . Das CDynamicOutputPin::m_hStopEvent-Ereignis wird zurückgesetzt. Wenn der Besitzerfilter nicht SetConfigInfo aufgerufen hat, gibt diese Methode E_FAIL zurück.

Anforderungen

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

Siehe auch

CDynamicOutputPin-Klasse