IRenderEngine：：ConnectFrontEnd 方法
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
注意
[已被取代。 此 API 可能會從未來的 Windows 版本中移除。]
ConnectFrontEnd方法會從目前的時程表建置篩選圖形的前端。
語法
HRESULT ConnectFrontEnd();
參數
這個方法沒有任何參數。
傳回值
傳回 HRESULT 值。 可能的傳回值包括下列各項：
| 傳回碼 | 描述 |
|---|---|
|
成功。 |
|
圖形的轉譯部分已刪除。 |
|
此轉譯引擎未設定時程表。 |
|
轉譯引擎無法初始化。 |
|
作業失敗，因為專案未成功轉譯。 |
|
非預期的錯誤。 |
|
不正確媒體類型。 |
備註
這個方法不會建置篩選圖形的轉譯部分。 應用程式必須將前端上的輸出釘選連接到所需的轉譯篩選器：
- 若要預覽，請呼叫 IRenderEngine：：RenderOutputPins 方法。
- 若要輸出檔案，請呼叫 IRenderEngine：：GetGroupOutputPin 以擷取每個群組的輸出釘選，然後將針腳連接到多工篩選器。
如果您使用基本轉譯引擎，前端上的輸出釘選會產生未壓縮的資料。 如果您使用智慧轉譯引擎，輸出釘選會產生壓縮的資料。
如果您在建置篩選圖形之後變更時程表，則必須再次呼叫 ConnectFrontEnd 以重建前端。 方法會盡可能保留圖形的轉譯部分。 不過，如果您新增或刪除群組，或變更群組的順序，請刪除轉譯部分， ConnectFrontEnd 而且您的應用程式必須重建它。 如果方法刪除轉譯部分，則會傳回S_WARN_OUTPUTRESET。
注意
標頭檔 Qedit.h 與 7 版之後的 Direct3D 標頭不相容。
注意
若要取得 Qedit.h，請下載適用于 Windows Vista 的 Microsoft Windows SDK Update 和 .NET Framework 3.0。 Windows 7 和 .NET Framework 3.5 Service Pack 1 Microsoft Windows SDK中無法使用 Qedit.h。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱