structure D3DHAL_DP2ADDDIRTYRECT (d3dhal.h)

2025-02-06

DirectX 8.1 et versions ultérieures uniquement.

D3DHAL_DP2ADDDIRTYRECT est utilisé pour spécifier qu’une partie d’une ressource 2D --une texture 2D ou texture de cube-a été souillée dans la mémoire système. Par conséquent, cette texture 2D doit être rechargée en mémoire vidéo avant d’être utilisée.

Syntaxe

typedef struct _D3DHAL_DP2ADDDIRTYRECT {
  DWORD dwSurface;
  RECTL rDirtyArea;
} D3DHAL_DP2ADDDIRTYRECT;

Membres

dwSurface

Spécifie le handle de la ressource 2D managée qui contient une texture 2D sale.

rDirtyArea

Spécifie la texture 2D marquée comme sale. Il s’agit d’une structure RECTL.

Remarques

D3DHAL_DP2ADDDIRTYRECT, ainsi que le jeton DP2OP_ADDDIRTYRECT, est utilisé uniquement pour les ressources gérées par le pilote et les surfaces. D3DHAL_DP2ADDDIRTYRECT n’est jamais envoyé, sauf si le pilote indique qu’il gère les ressources. Pour indiquer qu’il gère les ressources, le pilote doit définir le bit DDCAPS2_CANMANAGERESOURCE, en plus du bit DDCAPS2_CANMANAGETEXTURE, dans le membre dwCaps2 d’une structure DDCORECAPS. Le pilote spécifie cette structure DDCORECAPS dans le membre ddCaps d’une structure DD_HALINFO lorsque la fonction DrvGetDirectDrawInfo du pilote est appelée pour initialiser le composant DirectDraw du pilote.