IDDrawExclModeVideo::GetDDrawSurface 方法 (strmif.h)

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

方法 GetDDrawSurface 會擷取覆迭混音器所使用的 DirectDraw 表面。

語法

HRESULT GetDDrawSurface(
  [out] IDirectDrawSurface **ppDDrawSurface,
  [out] BOOL               *pbUsingExternal
);

參數

[out] ppDDrawSurface

重迭混音器正在使用之 IDirectDrawSurface 介面的指標位址。

[out] pbUsingExternal

接收布林值的變數指標。 如果重迭混音器使用IDDrawExclModeVideo::SetDDrawSurface或 FALSE 所指定的 DirectDraw 表面,則會接收TRUE 值

傳回值

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

傳回碼 描述
S_OK
成功。
E_INVALIDARG
引數無效。
DirectDraw 錯誤碼
嘗試在重迭混音器上設定指定的表面時,會發生 DirectDraw 錯誤。

備註

如果篩選圖表尚未設定 DirectDraw 表面,且重迭混音器尚未配置一個介面,則 pDDrawSurface 會設定為 Null並將 pdUsingExternal 設定為 FALSE

規格需求

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

另請參閱

錯誤和成功碼

IDDrawExclModeVideo 介面