IBaseFilter：：FindPin 方法 (strmif.h)

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

方法 FindPin 會擷取具有指定識別碼的針腳。

語法

HRESULT FindPin(
  [in]  LPCWSTR Id,
  [out] IPin    **ppPin
);

參數

[in] Id

識別針腳的常數寬字元字串指標。 呼叫 IPin：：QueryId 方法來擷取針腳的識別碼。

[out] ppPin

接收針腳 IPin 介面指標的變數位址。 如果方法失敗， *ppPin 會設定為 Null。

傳回值

傳回 HRESULT 值。 可能的值如下。

備註

這個方法支援圖形持續性。 使用 IPin：：QueryId 方法來儲存針腳的狀態，並使用這個方法來還原狀態。 針腳的識別碼字串是由篩選實作所定義。 識別碼在篩選準則內必須是唯一的。

如果方法成功，則傳回的 IPin 介面具有未處理的參考計數。 當您完成時，請務必釋放介面。

規格需求

另請參閱

錯誤和成功碼

IBaseFilter 介面