Share via

IDCompositionDevice：：CreateSurface 方法 (dcomp.h)

  • 發行項

建立可更新的介面物件，該物件可以與一或多個視覺效果相關聯以進行組合。

語法

HRESULT CreateSurface(
  [in]  UINT                 width,
  [in]  UINT                 height,
  [in]  DXGI_FORMAT          pixelFormat,
  [in]  DXGI_ALPHA_MODE      alphaMode,
  [out] IDCompositionSurface **surface
);

參數

[in] width

類型： UINT

介面的寬度，以圖元為單位。

[in] height

類型： UINT

表面的高度，以圖元為單位。

[in] pixelFormat

類型： DXGI_FORMAT

表面的像素格式。

[in] alphaMode

類型： DXGI_ALPHA_MODE

如果 Alpha 色板包含在像素格式中，則 Alpha 色板的格式。 它可能是下列其中一個值：

值 意義
DXGI_ALPHA_MODE_UNSPECIFIED 未指定 Alpha 色板。 這個值的效果與 DXGI_ALPHA_MODE_IGNORE相同。
DXGI_ALPHA_MODE_PREMULTIPLIED 色彩色板包含預先乘以 Alpha 色板的值。
DXGI_ALPHA_MODE_IGNORE 應忽略 Alpha 色板，而且點陣圖應該不透明地轉譯。

[out] surface

類型： IDCompositionSurface**

新建立的 Surface 物件。 此參數不得為 Null。

傳回值

類型： HRESULT

如果函式成功，它會傳回S_OK。 否則，它會傳回 HRESULT 錯誤碼。 如需錯誤碼的清單，請參閱 DirectComposition 錯誤 碼。

備註

Microsoft DirectComposition 介面是一個矩形的圖元陣列，可以與視覺效果建立關聯以進行組合。

新建立的 Surface 物件處於未初始化的狀態。 雖然未初始化，但介面對視覺化樹狀結構的組合沒有任何作用。 其行為與具有 100% 透明圖元的表面完全相同。

若要使用圖元資料初始化表面，請使用 IDCompositionSurface：：BeginDraw 方法。 此方法的第一次呼叫必須涵蓋整個介面區，以提供每個圖元的初始值。 後續呼叫可能會指定要更新之介面的較小子矩形。

DirectComposition 介面支援下列像素格式：

  • DXGI_FORMAT_B8G8R8A8_UNORM
  • DXGI_FORMAT_R8G8B8A8_UNORM
  • DXGI_FORMAT_R16G16B16A16_FLOAT

規格需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 dcomp.h
程式庫 Dcomp.lib
Dll Dcomp.dll

另請參閱

IDCompositionDevice

IDCompositionDevice：：CreateVirtualSurface