structure D3DHAL_DP2ADDDIRTYBOX (d3dhal.h)

Article
02/23/2024

DirectX 8.1 et versions ultérieures uniquement.

D3DHAL_DP2ADDDIRTYBOX est utilisé pour spécifier qu’une partie d’une ressource 3D(une texture de volume) a été souillée dans la mémoire système. Par conséquent, ce volume doit être rechargé dans la mémoire vidéo avant d’être utilisé.

Syntaxe

typedef struct _D3DHAL_DP2ADDDIRTYBOX {
  DWORD  dwSurface;
  D3DBOX DirtyBox;
} D3DHAL_DP2ADDDIRTYBOX;

Membres

dwSurface

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

DirtyBox

Spécifie la texture de volume marquée comme sale. Il s’agit d’une structure D3DBOX, qui est décrite dans la documentation Microsoft Windows SDK.

Remarques

D3DHAL_DP2ADDDIRTYBOX, ainsi que le jeton DP2OP_ADDDIRTYBOX, sont utilisés uniquement pour les ressources gérées par le pilote. D3DHAL_DP2ADDDIRTYBOX 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 DDCAPS2_CANMANAGERESOURCE bit, 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.