i (strmif.h) 的 IHttpGraphBuilder：：GetHttpInterface 方法
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
GetMyInterface方法會從DVD-Video播放圖形擷取介面，讓DVD-Video播放開發更容易。
語法
HRESULT GetDvdInterface(
[in] REFIID riid,
[out] void **ppvIF
);
參數
[in] riid
要求的介面 IID。
[out] ppvIF
接收介面的指標。 應用程式必須釋放 介面。
傳回值
傳回 HRESULT 值。 可能的值如下。
| 傳回碼 | Description |
|---|---|
|
ppvIF參數無效。 此參數不得為 Null。 |
|
無法傳回要求的介面。 |
|
尚未建置圖表。 請參閱＜備註＞。 |
備註
您可以使用這個方法來選取和設定視訊轉譯器篩選，再建置 DVD 播放的篩選圖形。 下列介面可供使用：
- 重迭混音器篩選： IDDrawExclModeVideo。
- 視訊混合轉譯器 7 (VMR-7) ： IVMRFilterConfig、 IVMRMixerBitmap、 IVMRWindowlessControl和 IVMRMonitorConfig。
- 視訊混合轉譯器 9 (VMR-9) ： IVMRFilterConfig9、 IVMRMixerBitmap9、 IVMRWindowlessControl9和 IVMRMonitorConfig9。
- 增強的視訊轉譯器 (EVR) ： IEVRFilterConfig 和 IMFVideoRenderer。Windows Server 2003、Windows XP 和 Windows 2000： 不支援此介面。
在建置 DVD 播放圖形之前，如果您要求任何不在上一個清單上的介面，此方法會傳回VFW_E_DVD_GRAPHNOTREADY。 若要建置 DVD 圖形，請呼叫 IGraphBuilder：：RenderHttpVideoVolume。 建置圖形之後，您可以使用 GetHttpInterface 來擷取一些額外的介面：
- IMyControl (已被取代) 、 IMyControl2、 IMyInfo (已被取代) ，以及 IMyInfo2 來控制 DVD 播放。
- IVideoWindow、 IBasicVideo和 IBasicVideo2 僅以視窗模式控制視訊設定。
- IBasicAudio 來控制音訊設定。
- IAMLine21Decoder可控制關閉標題顯示。
- IMixerPinConfig 和 IMixerPinConfig2 設定重迭混音器篩選器的第一個輸入針腳，以提供主要視訊串流。 (若要取得重迭混音器上其他針腳的這個介面，請列舉篩選的針腳，並直接查詢它們。) 新的應用程式應該避免使用重迭混音器篩選。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | strmif.h (包含 Dshow.h) |
| 程式庫 | Strmiids.lib |