structure D3DHAL_DP2CLEAR (d3dhal.h)

Article
02/06/2025

D3DHAL_DP2CLEAR contient toutes les informations dont le pilote a besoin pour effectuer une effacement matérielle sur la cible de rendu, la mémoire tampon de profondeur ou la mémoire tampon de gabarit.

Syntaxe

typedef struct _D3DHAL_DP2CLEAR {
  DWORD    dwFlags;
  DWORD    dwFillColor;
  D3DVALUE dvFillDepth;
  DWORD    dwFillStencil;
  RECT     Rects[1];
} D3DHAL_DP2CLEAR;

Membres

dwFlags

Spécifie les mémoires tampons que le pilote doit effacer. Ce membre peut être une OR au niveau du bit des valeurs suivantes :

valeur	Signification
D3DCLEAR_TARGET	Le pilote doit effacer la cible de rendu du contexte sur la couleur spécifiée par le membre dwFillColor.
D3DCLEAR_STENCIL	Le pilote doit effacer la mémoire tampon de gabarit du contexte sur la valeur spécifiée par le membre dwFillStencil.
D3DCLEAR_ZBUFFER	Le pilote doit effacer la mémoire tampon de profondeur du contexte à la profondeur spécifiée par le membre dwFillDepth.
D3DCLEAR_COMPUTERECTS	DirectX 8.0 et versions ultérieures uniquement. Si cet indicateur est défini, les rectangles spécifiés doivent être coupés par rapport à la fenêtre d’affichage actuelle. En outre, il est possible que lorsque D3DCLEAR_COMPUTERECTS est spécifié, le nombre de rectangles à effacer peut être égal à zéro (le nombre de rectangles à effacer peut être trouvé dans l’union wStateCount/wPrimtiveCount de la structure D3DHAL_DP2COMMAND pour l’effacement). Dans ce cas, la fenêtre d’affichage entière doit être effacée.

dwFillColor

Spécifie la couleur dans laquelle le pilote doit effacer la cible de rendu du contexte.

dvFillDepth

Spécifie la 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. Le pilote doit convertir cette valeur en entier à l’aide de la structure dwZBitMask membre de la structure DDPIXELFORMAT de la mémoire tampon de profondeur.

dwFillStencil

Spécifie la valeur à laquelle le pilote doit effacer la mémoire tampon de gabarit du contexte. Ce membre peut être un entier dans l’intervalle 0 à 2ⁿ-1, où n est le nombre de bits dans la mémoire tampon de gabarit.

Rects[1]

Spécifie les zones rectangulaires de la mémoire tampon que le pilote doit effacer. Les rectangles sont spécifiés dans les coordonnées de l’écran. Ce membre de la structure contient la première zone de rectangle à bliter. Le wStateCount membre de l'D3DHAL_DP2COMMAND contient le nombre total de zones de rectangle à blitter. Les autres structures RECT (wStateCount-1) requises suivent la structure D3DHAL_DP2CLEAR sans remplissage.

Remarques

Cette structure est utilisée avec le jeton de commande D3DDP2OP_CLEAR pour remplacer les rappels D3dClear hérités et D3dClear2.

Il est important de noter que lorsque le nombre de rectangles est égal à zéro, la structure de données D3DHAL_DP2CLEAR inclut toujours de l’espace pour un seul RECT. Ainsi, la taille de ce RECT unique doit être incluse lors de l’avancement vers l’instruction DP2 suivante. Toutefois, le contenu du RECT dans ce cas n’est pas défini et le pilote ne doit pas tenter de les lire.

Les pilotes d’affichage doivent convertir les valeurs de couleur d’entrée pour les classes ARVB et YUV des formats de couleurs. Pour les opérations claires, les valeurs de couleur d’entrée sont spécifiées dans le membre dwFillColor. Pour plus d’informations, consultez Gestion des valeurs de couleur pour les formats pixels.

Exigences

Exigence	Valeur
d’en-tête	d3dhal.h (include D3dhal.h)

Voir aussi

D3DDP2OP_CLEAR

D3DHAL_DP2COMMAND

DDPIXELFORMAT

Partager via