CPullPin.Active-Methode

  • Artikel

[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 Active-Methode erstellt einen Workerthread, der Daten aus dem Ausgabepin abruft. Diese Methode committet auch die Zuweisung.

Syntax

HRESULT Active();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
S_OK
 Erfolg.
E_UNEXPECTED
 Die Pinverbindung wurde nicht ordnungsgemäß hergestellt.
E_FAIL
 Der Thread konnte nicht erstellt werden, oder der Thread ist bereits vorhanden.

Bemerkungen

Rufen Sie diese Methode auf, wenn der besitzende Filter aktiv wird. (Wenn Ihr Eingabepin von CBasePin abgeleitet ist, überschreiben Sie die CBasePin::Active-Methode .)

Rufen Sie vor dem Aufrufen dieser Methode die CPullPin::Connect-Methode auf, um die Verbindung mit dem Ausgabepin herzustellen.

Anforderungen

Anforderung Wert
Header
Pullpin.h
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CPullPin-Klasse