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) |