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 |