struttura D3DDDIARG_CLEAR (d3dumddi.h)

Articolo
02/06/2025

La struttura D3DDDIARG_CLEAR descrive i parametri di un'operazione di cancellazione assistita dall'hardware.

Sintassi

typedef struct _D3DDDIARG_CLEAR {
  [in] UINT  Flags;
  [in] UINT  FillColor;
  [in] FLOAT FillDepth;
  [in] UINT  FillStencil;
} D3DDDIARG_CLEAR;

Membri

[in] Flags

Valore UINT che specifica quali buffer devono essere cancellati dal driver e come deve essere eseguita l'operazione di cancellazione. Questo membro può essere un OR bit per bit dei valori seguenti. Per altre informazioni, vedere la sezione Osservazioni nella pagina di riferimento Clear.

valore	significato
D3DCLEAR_TARGET (0x00000001l)	Il driver deve cancellare la destinazione di rendering del contesto sul colore specificato dal membro FillColor. Questo valore è definito in D3d8types.h.
D3DCLEAR_STENCIL (0x00000004l)	Il driver deve cancellare il buffer degli stencil del contesto sul valore specificato dal membro FillStencil. Questo valore è definito in D3d8types.h.
D3DCLEAR_ZBUFFER (0x00000002l)	Il driver deve cancellare il buffer di profondità del contesto fino alla profondità specificata dal membro FillDepth. Questo valore è definito in D3d8types.h.
D3DCLEAR_COMPUTERECTS (0x00000008l)	Se vengono specificati rettangoli per la cancellazione, il driver deve ritagliarli sul riquadro di visualizzazione corrente. Se non vengono specificati rettangoli, il driver deve cancellare l'intero riquadro di visualizzazione. Questo valore è definito in D3dhal.h.

[in] FillColor

Valore del colore su cui il driver deve cancellare la destinazione di rendering del contesto.

[in] FillDepth

Valore che il driver deve usare per impostare la profondità nel buffer di profondità del contesto. Questo membro può essere un valore compreso nell'intervallo compreso tra 0,0 e 1,0.

[in] FillStencil

Valore in cui il driver deve cancellare il buffer degli stencil del contesto. Questo membro può essere un numero intero compreso tra 0 e 2ⁿ-1, dove n è il numero di bit nel buffer degli stencil.

Osservazioni

In una chiamata alla funzione clear del driver di visualizzazione in modalità utente, viene passato un puntatore a una struttura di D3DDDIARG_CLEAR nel parametro pData. Il runtime Di Microsoft Direct3D passa informazioni ai parametri NumRect e pRect in una chiamata alla funzione Clear del driver di visualizzazione in modalità utente per specificare le aree rettangolari del buffer che il driver deve cancellare.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
intestazione	d3dumddi.h (include D3dumddi.h)

Vedere anche

Cancella

Condividi tramite