Método IDCompositionDevice::CreateSurface (dcomp.h)
Cria um objeto de superfície atualizável que pode ser associado a um ou mais visuais para composição.
Sintaxe
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
A largura da superfície, em pixels.
[in] height
Tipo: UINT
A altura da superfície, em pixels.
[in] pixelFormat
Tipo: DXGI_FORMAT
O formato de pixel da superfície.
[in] alphaMode
Tipo: DXGI_ALPHA_MODE
O formato do canal alfa, se um canal alfa estiver incluído no formato de pixel. Pode ser um dos seguintes valores:
| Valor | Significado |
|---|---|
| DXGI_ALPHA_MODE_UNSPECIFIED | O canal alfa não é especificado. Esse valor tem o mesmo efeito que DXGI_ALPHA_MODE_IGNORE. |
| DXGI_ALPHA_MODE_PREMULTIPLIED | Os canais de cores contêm valores pré-multiplicados pelo canal alfa. |
| DXGI_ALPHA_MODE_IGNORE | O canal alfa deve ser ignorado e o bitmap deve ser renderizado opacamente. |
[out] surface
Tipo: IDCompositionSurface**
O objeto surface recém-criado. Esse parâmetro não deve ser NULL.
Retornar valor
Tipo: HRESULT
Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de Erro do DirectComposition para obter uma lista de códigos de erro.
Comentários
Uma superfície do Microsoft DirectComposition é uma matriz retangular de pixels que pode ser associada a um visual para composição.
Um objeto surface recém-criado está em um estado não inicializado. Embora não seja inicializada, a superfície não tem efeito na composição da árvore visual. Ele se comporta exatamente como uma superfície que tem pixels 100% transparentes.
Para inicializar a superfície com dados de pixel, use o método IDCompositionSurface::BeginDraw . A primeira chamada a esse método deve abranger toda a área da superfície para fornecer um valor inicial para cada pixel. Chamadas subsequentes podem especificar sub-retângulos menores da superfície a serem atualizados.
As superfícies DirectComposition dão suporte aos seguintes formatos de pixel:
- DXGI_FORMAT_B8G8R8A8_UNORM
- DXGI_FORMAT_R8G8B8A8_UNORM
- DXGI_FORMAT_R16G16B16A16_FLOAT
Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | dcomp.h |
| Biblioteca | Dcomp.lib |
| DLL | Dcomp.dll |