D3DDDIARG_CLEAR structure (d3dumddi.h)

Article
08/07/2023

La structure D3DDDIARG_CLEAR décrit les paramètres d’une opération de suppression assistée par matériel.

Syntaxe

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

Membres

[in] Flags

Valeur UINT qui spécifie les mémoires tampons que le pilote doit effacer et la façon dont l’opération d’effacement doit être effectuée. Ce membre peut être un or au niveau du bit des valeurs suivantes. Pour plus d’informations, consultez la section Notes de la page Effacer la référence.

Valeur	Signification
D3DCLEAR_TARGET (0x00000001l)	Le pilote doit effacer la cible de rendu du contexte à la couleur spécifiée par le membre FillColor. Cette valeur est définie dans D3d8types.h.
D3DCLEAR_STENCIL (0x00000004l)	Le pilote doit effacer la mémoire tampon de gabarit du contexte à la valeur spécifiée par le membre FillStencil. Cette valeur est définie dans D3d8types.h.
D3DCLEAR_ZBUFFER (0x00000002l)	Le pilote doit effacer la mémoire tampon de profondeur du contexte à la profondeur spécifiée par le membre FillDepth. Cette valeur est définie dans D3d8types.h.
D3DCLEAR_COMPUTERECTS (0x0000008l)	Si des rectangles sont spécifiés pour l’effacement, le pilote doit les découper par rapport à la fenêtre d’affichage actuelle. Si aucun rectangle n’est spécifié, le pilote doit effacer l’intégralité de la fenêtre d’affichage. Cette valeur est définie dans D3dhal.h.

[in] FillColor

Valeur de couleur à laquelle le pilote doit effacer la cible de rendu du contexte.

[in] FillDepth

Valeur que le pilote doit utiliser pour définir la profondeur dans la mémoire tampon de profondeur du contexte. Ce membre peut être une valeur comprise entre 0,0 et 1,0.

[in] FillStencil

Valeur à laquelle le pilote doit effacer la mémoire tampon de gabarit du contexte. Ce membre peut être un entier dans la plage comprise entre 0 et 2ⁿ-1, où n est le nombre de bits dans la mémoire tampon de gabarit.

Remarques

Dans un appel à la fonction Clear du pilote d’affichage en mode utilisateur, un pointeur vers une structure D3DDDIARG_CLEAR est passé dans le paramètre pData . Le runtime Microsoft Direct3D transmet des informations aux paramètres NumRect et pRect dans un appel à la fonction Clear du pilote d’affichage en mode utilisateur pour spécifier les zones rectangulaires de la mémoire tampon que le pilote doit effacer.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	d3dumddi.h (inclure D3dumddi.h)

Voir aussi

Clear