CBaseFilter.EnumPins-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 EnumPins -Methode listet die Pins für diesen Filter auf. Diese Methode implementiert die IBaseFilter::EnumPins-Methode .

Syntax

HRESULT EnumPins(
   IEnumPins **ppEnum
);

Parameter

ppEnum

Adresse einer Variablen, die einen Zeiger auf die IEnumPins-Schnittstelle empfängt .

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg
E_OUTOFMEMORY	Der Arbeitsspeicher reicht nicht aus
E_POINTER	NULL-Zeigerargument

Bemerkungen

Diese Methode erstellt eine instance der CEnumPins-Basisklasse und gibt einen Zeiger auf dieses Objekt vom Typ IEnumPins zurück. Die CEnumPins-Klasse ruft die CBaseFilter::GetPin-Methode des Filters auf, um die Pins für den Filter aufzulisten.

Wenn diese Methode erfolgreich ist, weist die IEnumPins-Schnittstelle eine ausstehende Verweisanzahl auf. Der Aufrufer muss die Schnittstelle freigeben.

Anforderungen

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

Siehe auch

CBaseFilter-Klasse