Metodo IDCompositionDevice2::CreateSurface (dcomp.h)

Articolo
03/13/2024

Crea un oggetto superficie aggiornabile che può essere associato a uno o più oggetti visivi per la composizione.

Sintassi

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

Parametri

[in] width

Tipo: UINT

Larghezza della superficie, in pixel. Vincolato dal livello di funzionalità del dispositivo di rendering passato al momento della creazione del dispositivo DirectComposition.

[in] height

Tipo: UINT

Altezza della superficie, in pixel. Vincolato dal livello di funzionalità del dispositivo di rendering passato al momento della creazione del dispositivo DirectComposition.

[in] pixelFormat

Tipo: DXGI_FORMAT

Formato pixel della superficie.

[in] alphaMode

Tipo: DXGI_ALPHA_MODE

Formato del canale alfa, se nel formato pixel è incluso un canale alfa. Può essere uno dei valori seguenti:

Valore	Significato
DXGI_ALPHA_MODE_UNSPECIFIED	Il canale alfa non è specificato. Questo valore ha lo stesso effetto di DXGI_ALPHA_MODE_IGNORE.
DXGI_ALPHA_MODE_PREMULTIPLIED	I canali di colore contengono valori premoltiplicati con il canale alfa.
DXGI_ALPHA_MODE_IGNORE	Il canale alfa deve essere ignorato e il rendering della bitmap deve essere opacamente.

[out] surface

Tipo: IDCompositionSurface**

Oggetto superficie appena creato. Questo parametro non deve essere NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore directComposition .

Commenti

Una superficie Microsoft DirectComposition è una matrice rettangolare di pixel che può essere associata a un oggetto visivo per la composizione.

Un oggetto superficie appena creato si trova in uno stato non inizializzato. Sebbene non sia inizializzata, la superficie non ha alcun effetto sulla composizione dell'albero visivo. Si comporta esattamente come una superficie con pixel trasparenti al 100%.

Per inizializzare la superficie con i dati pixel, usare i metodi IDCompositionSurface::BeginDraw e IDCompositionSurface::EndDraw . La prima chiamata a questo metodo deve coprire l'intera superficie di attacco per fornire un valore iniziale per ogni pixel. Le chiamate successive possono specificare rettangoli secondari più piccoli della superficie da aggiornare.

Le superfici DirectComposition supportano i formati pixel seguenti:

DXGI_FORMAT_B8G8R8A8_UNORM
DXGI_FORMAT_R8G8B8A8_UNORM
DXGI_FORMAT_R16G16B16A16_FLOAT

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dcomp.h
Libreria	Dcomp.lib
DLL	Dcomp.dll

Vedi anche

IDCompositionDevice2

IDCompositionDevice2::CreateVirtualSurface

Condividi tramite