Método IDCompositionDevice::CreateSurface (dcomp.h)

Crea un objeto de superficie actualizable que se puede asociar a uno o varios objetos visuales para la composición.

Sintaxis

HRESULT CreateSurface(
  [in]  UINT                 width,
  [in]  UINT                 height,
  [in]  DXGI_FORMAT          pixelFormat,
  [in]  DXGI_ALPHA_MODE      alphaMode,
  [out] IDCompositionSurface **surface
);

Parámetros

[in] width

Tipo: UINT

Ancho de la superficie, en píxeles.

[in] height

Tipo: UINT

Alto de la superficie, en píxeles.

[in] pixelFormat

Tipo: DXGI_FORMAT

Formato de píxel de la superficie.

[in] alphaMode

Tipo: DXGI_ALPHA_MODE

Formato del canal alfa, si se incluye un canal alfa en formato de píxel. Puede ser uno de los siguientes valores:

Valor	Significado
DXGI_ALPHA_MODE_UNSPECIFIED	No se especifica el canal alfa. Este valor tiene el mismo efecto que DXGI_ALPHA_MODE_IGNORE.
DXGI_ALPHA_MODE_PREMULTIPLIED	Los canales de color contienen valores que se premultiplican con el canal alfa.
DXGI_ALPHA_MODE_IGNORE	El canal alfa debe omitirse y el mapa de bits debe representarse opacamente.

[out] surface

Tipo: IDCompositionSurface**

Objeto de superficie recién creado. 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 código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.

Comentarios

Una superficie de Microsoft DirectComposition es una matriz rectangular de píxeles que se puede asociar a un objeto visual para la composición.

Un objeto de superficie recién creado está en un estado no inicializado. Aunque no se inicializa, la superficie no tiene ningún efecto en la composición del árbol visual. Se comporta exactamente como una superficie que tiene un 100 % píxeles transparentes.

Para inicializar la superficie con datos de píxeles, use el método IDCompositionSurface::BeginDraw . La primera llamada a este método debe cubrir todo el área expuesta para proporcionar un valor inicial para cada píxel. Las llamadas posteriores pueden especificar subctángulos más pequeños de la superficie que se van a actualizar.

Las superficies directComposition admiten los siguientes formatos de píxel:

• DXGI_FORMAT_B8G8R8A8_UNORM
• DXGI_FORMAT_R8G8B8A8_UNORM
• DXGI_FORMAT_R16G16B16A16_FLOAT

Requisitos

Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dcomp.h
Library	Dcomp.lib
Archivo DLL	Dcomp.dll

Vea también

IDCompositionDevice

IDCompositionDevice::CreateVirtualSurface