Compartir a través de

Función DCompositionCreateSurfaceHandle (dcomp.h)

  • Artículo

Crea un nuevo objeto de superficie de composición que se puede enlazar a una cadena de intercambio o búfer de intercambio de Microsoft DirectX y asociado a un objeto visual.

Sintaxis

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

Parámetros

[in] desiredAccess

Tipo: DWORD de

Acceso solicitado al objeto de superficie de composición. Puede ser uno de los siguientes valores:

Valor Significado
0x0000L
 Sin acceso.
COMPOSITIONOBJECT_READ
0x0001L
 Acceso de lectura. Solo para uso interno.
COMPOSITIONOBJECT_WRITE
0x0002L
 Acceso de escritura. Solo para uso interno.
COMPOSITIONOBJECT_ALL_ACCESS
0x0003L
 Acceso de lectura y escritura. Especifique siempre esta marca excepto al duplicar una superficie en otro proceso, en cuyo caso establezca desiredAccess en 0.

[in, optional] securityAttributes

Tipo: SECURITY_ATTRIBUTES*

Contiene el descriptor de seguridad para el objeto de superficie de composición y especifica si el identificador del objeto de superficie de composición se puede heredar cuando se crea un proceso secundario. Si este parámetro es NULL, el objeto de superficie de composición se crea con atributos de seguridad predeterminados que conceden acceso de lectura y escritura al proceso actual, pero no permiten que los procesos secundarios hereden el identificador.

[out] surfaceHandle

Tipo: HANDLE de

Identificador del nuevo objeto de superficie de composición. Este parámetro no debe ser NULL.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error. Consulte códigos de error directComposition para obtener una lista de códigos de error.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 8 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2012 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de dcomp.h
biblioteca de Dcomp.lib
DLL de Dcomp.dll