iCaptureGraphBuilder2：：FindPin 方法 (strmif.h)
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
方法 FindPin 會擷取篩選上的特定針腳，或判斷指定的針腳是否符合指定的準則。
語法
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
);
參數
[in] pSource
篩選上的介面指標，或針腳上的介面指標。
[in] pindir
指定輸入或輸出) (針腳方向的 PIN_DIRECTION 列舉成員。
[in] pCategory
GUID 的指標，指定 Pin 屬性集中所列的其中一個針腳類別。 若要比對任何針腳，不論類別為何，請將此參數設定為 Null。
[in] pType
指定媒體類型之主要類型 GUID 的指標。 使用 Null 來比對任何媒體類型。
[in] fUnconnected
布林值，指定針腳是否必須未連接。 如果 為 TRUE，則針腳必須未連接。 如果 為 FALSE，則可以連接或未連接針腳。
[in] num
要擷取之釘選的以零起始的索引，從相符的針腳集合中擷取。 如果 pSource 是篩選的指標，而且多個釘選符合搜尋準則，則此參數會指定要擷取的釘選。 如果 pSource 是針腳的指標，則會忽略此參數。
[out] ppPin
要接收相符針腳 之 IPin 介面的指標位址。
傳回值
如果找到相符的針腳，則傳回S_OK，否則會傳回E_FAIL。
備註
如果 pSource 是篩選的指標，則方法會在符合搜尋準則的篩選上搜尋 第 n個針腳，其中 n 是由 num 參數指定。 如果方法找到相符的釘選，它會傳回 ppPin 參數中針腳的指標。
如果 pSource 是釘選的指標，則方法會根據搜尋準則測試該釘選。 如果針腳符合準則，方法會傳回S_OK，並在 ppPin 參數中傳回針腳的 IPin 介面指標。 否則會傳回E_FAIL。
不論是哪一種情況，如果方法成功， ppPin 參數中傳回的 IPin 介面會有未處理的參考計數。 當您完成使用介面時，請務必釋放介面。
一般而言，應用程式不需要使用這個方法。 當 ICaptureGraphBuilder2：：RenderStream 方法無法建置篩選圖形時，它會針對不尋常的複雜工作提供。 使用此方法可從擷取篩選器擷取所需的釘選，然後手動建置其餘圖形。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | strmif.h (包含 Dshow.h) |
| 程式庫 | Strmiids.lib |