通过

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

类型： 句柄*

新组合图面对象的句柄。 此参数不能为 NULL。

返回值

类型： HRESULT

如果函数成功，则返回S_OK。 否则，将返回 HRESULT 错误代码。 有关错误代码列表，请参阅 DirectComposition 错误代码。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 dcomp.h
Library Dcomp.lib
DLL Dcomp.dll