CBaseFilter.FindPin-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 FindPin -Methode ruft den Pin mit dem angegebenen Bezeichner ab. Diese Methode implementiert die IBaseFilter::FindPin-Methode .

Syntax

HRESULT FindPin(
   LPCWSTR Id,
   IPin    **ppPin
);

Parameter

Id

Zeiger auf eine konstante, NULL-beendete Unicode-Zeichenfolge, die den Pin identifiziert.

ppPin

Adresse einer Variablen, die einen Zeiger auf die IPin-Schnittstelle des Pins empfängt.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_POINTER
 NULL-Zeigerargument.
VFW_E_NOT_FOUND
 Es konnte kein passender Pin gefunden werden.

Bemerkungen

Diese Methode ruft die CBasePin::Name-Methode auf, um den Namen der einzelnen Pins mit der im Id-Parameter angegebenen Zeichenfolge zu vergleichen.

Wenn die Methode erfolgreich ist, weist die IPin-Schnittstelle eine hervorragende Verweisanzahl auf. Stellen Sie sicher, dass Sie es freigeben, wenn Sie fertig sind.

Anforderungen

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

Siehe auch

CBaseFilter-Klasse