CSource.FindPin-Methode

Artikel
07/28/2023

[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

Freigeben über