iGraphBuilder 介面 (strmif.h)

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

此介面提供可讓應用程式建置篩選圖形的方法。 Filter Graph 管理員會實作此介面。

IGraphBuilder 介面繼承自 IFilterGraph 介面。 IFilterGraph 提供基本作業，例如將篩選新增至圖形或連接兩個針腳。 IGraphBuilder 會新增從部分資訊建構圖形的進一步方法。 例如， IGraphBuilder：：RenderFile 方法會根據檔案的名稱來建置檔案播放的圖形。 IGraphBuilder：：Render 方法會藉由將新的篩選連線到針腳，從輸出釘選轉譯數據。

使用這些方法時，應用程式不需要在圖形中指定每個篩選和釘選連接。 相反地，篩選圖形管理員會選取在用戶系統上註冊的篩選、將它們新增至圖形，並連接它們。 如需詳細資訊，請參閱 Intelligent Connect。

繼承

IGraphBuilder 介面繼承自 IFilterGraph。 IGraphBuilder 也有下列類型的成員：

方法

IGraphBuilder 介面具有這些方法。

IGraphBuilder：：Abort Abort 方法會要求 Filter Graph 管理員儘快停止其目前的工作。
IGraphBuilder：：AddSourceFilter AddSourceFilter 方法會將指定檔案的來源篩選新增至篩選圖形。
IGraphBuilder：：Connect Connect 方法會視需要使用中繼來連接兩個針腳。
IGraphBuilder：：Render Render 方法會建置篩選圖形，以從指定的輸出釘選轉譯數據。
IGraphBuilder：：RenderFile RenderFile 方法會建置篩選圖形，以轉譯指定的檔案。 (IGraphBuilder.RenderFile)
IGraphBuilder：：SetLogFile SetLogFile 方法會設定檔案，以便記錄嘗試執行作業時所採取的動作。
IGraphBuilder：：ShouldOperationContinue ShouldOperationContinue 方法會查詢目前作業是否應該繼續。

規格需求

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

另請參閱

IFilterGraph

介面