Share via

iCaptureGraphBuilder2：：FindInterface 方法 (strmif.h)

  • 發行項

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

方法會 FindInterface 從指定的篩選開始，搜尋圖形中的指定介面。 您可以將搜尋限制為圖表上游或篩選下游的區段，或將它限制為特定的釘選類別或媒體類型。

語法

HRESULT FindInterface(
  [in]  const GUID  *pCategory,
  [in]  const GUID  *pType,
  [in]  IBaseFilter *pf,
  [in]  REFIID      riid,
  [out] void        **ppint
);

參數

[in] pCategory

指定搜尋準則之 GUID 的指標。 如需詳細資訊，請參閱「備註」。 以下是可能的值：

  • &LOOK_UPSTREAM_ONLY。
  • &LOOK_DOWNSTREAM_ONLY。
  • 釘選屬性集中列出的其中一個針腳類別。
  • NULL
如需詳細資訊，請參閱「備註」。

[in] pType

GUID 的指標，指定輸出釘選的主要媒體類型或 NULL。

[in] pf

篩選條件之 IBaseFilter 介面的指標。 方法會從這個篩選條件開始搜尋。

[in] riid

介面識別碼 (要尋找的介面) IID。

[out] ppint

接收介面指標的變數位址。 當您使用 介面完成時，請務必釋放擷取的介面指標。

傳回值

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

傳回碼 描述
S_OK
 成功。
E_FAIL
 失敗。
E_NOINTERFACE
 不支援這類介面。
E_POINTER
 NULL 指標自變數。

備註

在擷取圖表中，各種篩選和針腳可能會公開介面來設定屬性，例如壓縮參數 (IAMVideoCompression) 或數據流格式 (IAMStreamConfig) 。 根據擷取裝置，其他有用的介面可能包含 IAMCrossbar，其會路由類比訊號，或控制電視微調器裝置的 IAMTVTuner。 您可以使用這個方法來尋找介面，而不需撰寫周遊圖形的特殊程序代碼。

重要 請勿呼叫這個方法來取得 IVideoWindow 介面指標。 請一律查詢此介面的篩選圖形管理員。 否則，篩選圖形管理員將不會正確響應螢幕解析度和其他事件的變更。
 
如果 pCategory 參數為 NULL，這個方法會搜尋要求介面的整個圖形。 從 pf 參數指定的篩選開始，它會查詢圖形中的下列物件。
  • 篩選
  • 篩選條件的釘選
  • 所有下游篩選條件，包括其針腳
  • 所有上游篩選條件，包括其針腳
您可以設定 pCategory 和 pType 參數來限制搜尋，如下所示：
  • 如果 pCategory 等於 &LOOK_UPSTREAM_ONLY，搜尋會從篩選的輸入釘選開始，並繼續上游。 它不包含篩選條件或任何來自篩選條件的下游專案。 會忽略 pType 參數。
  • 如果 pCategory 等於 &LOOK_DOWNSTREAM_ONLY，則搜尋會從篩選的輸出釘選開始，並繼續下游。 它不包含篩選條件或任何來自篩選條件的上游。 會忽略 pType 參數。
  • 如果 pCategory 指定釘選類別，搜尋的下游部分會限制在符合 pType 參數中指定之釘選類別和媒體類型的篩選上輸出釘選。 在此情況下，方法也會搜尋篩選條件，並從篩選上游搜尋所有專案。
此外，如果 pCategory 不是 NULL，此方法可能會從 pf 中指定的篩選，將某些 Windows 驅動程式模型 (WDM) 篩選上游。 如需詳細資訊，請參閱本節底下的備註。

釘選類別適用於在擷取篩選上尋找針腳介面。 例如，擷取篩選可能會有個別的釘選來擷取和預覽。 如果您指定釘選類別，也應該指定媒體類型，確定方法會選取正確的篩選和釘選。

某些視訊擷取篩選器具有視訊埠釘選 (PIN_CATEGORY_VIDEOPORT) ，而不是預覽釘選。 如果您指定PIN_CATEGORY_PREVIEW和MEDIATYPE_Video，此方法會將任何視訊埠釘選視為預覽釘選。 您的應用程式不需要測試此可能性。

支持篩選。 如果擷取裝置使用 Windows 驅動程式模型 (WDM) 驅動程式，圖形可能需要 WDM 視訊擷取 篩選器上游的某些篩選，例如 電視微調器 篩選器或 類比視訊交叉篩選 條件。 如果 pCategory 參數不等於 NULL，這個方法會自動將任何必要的 WDM 篩選器插入圖形中。 若要這樣做，它會查詢擷取篩選上的輸入釘選，以判斷它們支持的媒體，並將其連線到相符的篩選。 如果 pCategory 參數為 NULL，則方法不會新增上游篩選。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

ICaptureGraphBuilder2 介面