ICaptureGraphBuilder2::FindPin-Methode (strmif.h)

[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 einen bestimmten Pin für einen Filter ab oder bestimmt, ob ein bestimmter Pin den angegebenen Kriterien entspricht.

Syntax

HRESULT FindPin(
  [in]  IUnknown      *pSource,
  [in]  PIN_DIRECTION pindir,
  [in]  const GUID    *pCategory,
  [in]  const GUID    *pType,
  [in]  BOOL          fUnconnected,
  [in]  int           num,
  [out] IPin          **ppPin
);

Parameter

[in] pSource

Zeiger auf eine Schnittstelle in einem Filter oder auf eine Schnittstelle an einem Pin.

[in] pindir

Member der PIN_DIRECTION-Enumeration , die die Pinrichtung (Eingabe oder Ausgabe) angibt.

[in] pCategory

Ein Zeiger auf eine GUID, die eine der im Pin-Eigenschaftensatz aufgeführten Anheftkategorien angibt. Legen Sie diesen Parameter auf NULL fest, um einen beliebigen Pin unabhängig von der Kategorie zuzuordnen.

[in] pType

Zeiger auf eine Haupttyp-GUID, die den Medientyp angibt. Verwenden Sie NULL , um einem beliebigen Medientyp zu entsprechen.

[in] fUnconnected

Boolescher Wert, der angibt, ob der Pin nicht verbunden sein muss. Bei TRUE muss die Verbindung des Pins aufgehoben werden. Bei FALSE kann der Pin verbunden oder die Verbindung aufgehoben werden.

[in] num

Nullbasierter Index des abzurufenden Pins aus dem Satz übereinstimmenden Pins. Wenn pSource ein Zeiger auf einen Filter ist und mehrere Pins den Suchkriterien entsprechen, gibt dieser Parameter an, welcher Pin abgerufen werden soll. Wenn pSource ein Zeiger auf einen Pin ist, wird dieser Parameter ignoriert.

[out] ppPin

Adresse eines Zeigers, um die IPin-Schnittstelle des übereinstimmenden Pins zu empfangen.

Rückgabewert

Gibt S_OK zurück, wenn ein übereinstimmende Pin gefunden wird, oder E_FAIL andernfalls.

Bemerkungen

Wenn pSource ein Zeiger auf einen Filter ist, sucht die Methode nach dem n-tenPin für diesen Filter, der den Suchkriterien entspricht, wobei n durch den Num-Parameter angegeben wird. Wenn die Methode einen übereinstimmenden Pin findet, gibt sie einen Zeiger auf den Pin im ppPin-Parameter zurück.

Wenn pSource ein Zeiger auf einen Pin ist, testet die Methode die Anheftung anhand der Suchkriterien. Wenn der Pin den Kriterien entspricht, gibt die Methode S_OK und einen Zeiger auf die IPin-Schnittstelle des Pins im ppPin-Parameter zurück. Andernfalls wird E_FAIL zurückgegeben.

Wenn die Methode erfolgreich ist, weist die im ppPin-Parameter zurückgegebene IPin-Schnittstelle eine ausstehende Verweisanzahl auf. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie sie verwenden.

In der Regel muss eine Anwendung diese Methode nicht verwenden. Sie wird für ungewöhnlich komplexe Aufgaben bereitgestellt, wenn die ICaptureGraphBuilder2::RenderStream-Methode das Filterdiagramm nicht erstellen kann. Verwenden Sie diese Methode, um einen gewünschten Pin aus einem Erfassungsfilter abzurufen und dann den Rest des Graphen manuell zu erstellen.

Anforderungen

Siehe auch

Fehler- und Erfolgscodes

ICaptureGraphBuilder2-Schnittstelle