共用方式為

DCompositionCreateSurfaceHandle 函式 （dcomp.h）

  • 發行項

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

語法

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

參數

[in] desiredAccess

類型：DWORD

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

價值 意義
0x0000L
 沒有存取權。
COMPOSITIONOBJECT_READ
0x0001L
 讀取許可權。 僅供內部使用。
COMPOSITIONOBJECT_WRITE
0x0002L
 寫入許可權。 僅供內部使用。
COMPOSITIONOBJECT_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 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 dcomp.h
連結庫 Dcomp.lib
DLL Dcomp.dll