Share via

DCompositionCreateSurfaceHandle 函式 (dcomp.h)

  • 發行項

建立新的組合介面物件，該物件可以系結至 Microsoft DirectX 交換鏈結或交換緩衝區，並與視覺效果相關聯。

語法

HRESULT DCompositionCreateSurfaceHandle(
  [in]           DWORD               desiredAccess,
  [in, optional] SECURITY_ATTRIBUTES *securityAttributes,
  [out]          HANDLE              *surfaceHandle
);

參數

[in] desiredAccess

類型： DWORD

對組合介面物件的要求存取權。 它可能是下列其中一個值：

值 意義
0x0000L
 沒有存取權。
COMPOSITIONSURFACE_READ
0x0001L
 讀取存取權。 僅供內部使用。
COMPOSITIONSURFACE_WRITE
0x0002L
 寫入存取權。 僅供內部使用。
COMPOSITIONSURFACE_ALL_ACCESS
0x0003L
 可擦寫的存取權。 請一律指定這個旗標，除非在另一個進程中複製表面時，在此情況下將 desiredAccess 設定為 0。

[in, optional] securityAttributes

類型： SECURITY_ATTRIBUTES*

包含組合介面物件的安全性描述項，並指定建立子進程時，組合介面物件的句柄是否可繼承。 如果此參數為 NULL，則會使用預設安全性屬性來建立組合介面物件，以授與目前進程的讀取和寫入存取權，但不會讓子進程繼承句柄。

[out] surfaceHandle

類型： HANDLE*

新組合介面物件的句柄。 此參數不得為 NULL。

傳回值

類型： HRESULT

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

規格需求

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