DCompositionCreateSurfaceHandle 函式 (dcomp.h)
建立新的組合介面物件,該物件可以系結至 Microsoft DirectX 交換鏈結或交換緩衝區,並與視覺效果相關聯。
語法
HRESULT DCompositionCreateSurfaceHandle(
[in] DWORD desiredAccess,
[in, optional] SECURITY_ATTRIBUTES *securityAttributes,
[out] HANDLE *surfaceHandle
);
參數
[in] desiredAccess
類型: DWORD
對組合介面物件的要求存取權。 它可能是下列其中一個值:
[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 |