Freigeben über

CSource.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 NULL-Zeichenfolge, die den Pin identifiziert.

ppPin

Empfängt einen Zeiger auf die IPin-Schnittstelle des Pins. Wenn die Methode fehlschlägt, wird *ppPin auf NULL festgelegt.

Rückgabewert

Gibt einen der in der folgenden Tabelle dargestellten HRESULT-Werte zurück.

Rückgabecode Beschreibung
S_OK
 Erfolg.
E_POINTER
 NULL-Zeigerargument.
VFW_E_NOT_FOUND
 Es konnte keine Pin mit diesem Bezeichner gefunden werden.

Bemerkungen

Der erste Pin heißt immer "1"; der zweite Pin heißt "2"; usw. Weitere Informationen finden Sie unter CSourceStream::QueryId.

Anforderungen

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

Siehe auch

CSource-Klasse