D3DHAL_DP2CLEAR structure (d3dhal.h)

Article
02/23/2024

D3DHAL_DP2CLEAR contient toutes les informations dont le pilote a besoin pour effectuer l’effacement assisté par le matériel 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 un or au niveau du bit des valeurs suivantes :

Valeur	Signification
D3DCLEAR_TARGET	Le pilote doit effacer la cible de rendu du contexte à la couleur spécifiée par le membre dwFillColor.
D3DCLEAR_STENCIL	Le pilote doit effacer la mémoire tampon de gabarit du contexte à 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, lorsque D3DCLEAR_COMPUTERECTS est spécifié, le nombre de rectangles à effacer peut être égal à zéro (le nombre de rectangles à effacer se trouve dans l’union wStateCount/wPrimtiveCount de la structure D3DHAL_DP2COMMAND pour le clear). Dans ce cas, la fenêtre d’affichage entière doit être effacée.

dwFillColor

Spécifie la couleur vers 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 du membre dwZBitMask de la structure DDPIXELFORMAT de la mémoire tampon de profondeur.

dwFillStencil

Spécifie la valeur vers 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 en coordonnées d’écran. Ce membre de la structure contient la première zone de rectangle à bliter. Le membre wStateCount du D3DHAL_DP2COMMAND contient le nombre total de zones de rectangle à prendre en compte. 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 et D3dClear2 hérités.

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. Par conséquent, 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 de couleurs ARGB et YUV des formats de couleur. Pour les opérations d’effacement, 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 de pixels.

Configuration requise

Condition requise	Valeur
En-tête	d3dhal.h (inclure D3dhal.h)

Voir aussi

D3DDP2OP_CLEAR

D3DHAL_DP2COMMAND

DDPIXELFORMAT

Partager via