通过

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