共用方式為

IDCompositionDevice2：：CreateVirtualSurface 方法 (dcomp.h)

  • 發行項

建立疏鬆填入的介面，以便與一或多個視覺效果建立關聯以進行組合。

語法

HRESULT CreateVirtualSurface(
  [in]  UINT                        initialWidth,
  [in]  UINT                        initialHeight,
  [in]  DXGI_FORMAT                 pixelFormat,
  [in]  DXGI_ALPHA_MODE             alphaMode,
  [out] IDCompositionVirtualSurface **virtualSurface
);

參數

[in] initialWidth

類型： UINT

介面的寬度，以像素為單位。 寬度上限為 16,777,216 圖元。

[in] initialHeight

類型： UINT

表面的高度，以像素為單位。 高度上限為 16,777,216 圖元。

[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] virtualSurface

類型： IDCompositionVirtualSurface**

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

傳回值

類型： HRESULT

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

備註

Microsoft DirectComposition 疏鬆表面是邏輯物件，其行為就像與視覺效果相關聯的矩形像素數位進行組合。 每一個像素的實體視訊或系統記憶體不一定支援表面。 應用程式可以在不同的時間實現或虛擬化邏輯介面的元件。

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

若要使用像素數據初始化表面，請使用 IDCompositionSurface：：BeginDraw 和 IDCompositionSurface：：EndDraw 方法。 這個方法不僅提供介面的圖元，也會為那些圖元配置實際的儲存空間。 記憶體配置會持續存在，直到應用程式將部分記憶體傳回系統為止。 應用程式可以藉由呼叫 IDCompositionVirtualSurface：：Trim 方法釋放部分或所有配置的記憶體。

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

  • DXGI_FORMAT_B8G8R8A8_UNORM
  • DXGI_FORMAT_R8G8B8A8_UNORM
  • DXGI_FORMAT_R16G16B16A16_FLOAT
如果 initialWidth 或 initialHeight 超過 16,777,216 像素，這個方法就會失敗。

規格需求

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

另請參閱

IDCompositionDevice2

IDCompositionDevice：：CreateSurface