struttura D3DHAL_DP2ADDDIRTYBOX (d3dhal.h)

Articolo
02/23/2024

Solo DirectX 8.1 e versioni successive.

D3DHAL_DP2ADDDIRTYBOX viene usato per specificare che una parte di una risorsa 3D, ovvero una trama del volume, è stata danneggiata nella memoria di sistema. Pertanto, questo volume deve essere ricaricato nella memoria video prima di essere usato.

Sintassi

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

Members

dwSurface

Specifica l'handle per la risorsa 3D gestita che contiene una trama del volume danneggiato.

DirtyBox

Specifica la trama del volume contrassegnata come deviata. Si tratta di una struttura D3DBOX, descritta nella documentazione di Microsoft Windows SDK.

Commenti

D3DHAL_DP2ADDDIRTYBOX, insieme al token di DP2OP_ADDDIRTYBOX, viene usato solo per le risorse gestite dal driver. D3DHAL_DP2ADDDIRTYBOX non viene mai inviato a meno che il driver non indichi che gestisce le risorse. Per indicare che gestisce le risorse, il driver deve impostare il bit DDCAPS2_CANMANAGERESOURCE, oltre al bit DDCAPS2_CANMANAGETEXTURE, nel membro dwCaps2 di una struttura DDCORECAPS. Il driver specifica questa struttura DDCORECAPS nel membro ddCaps di una struttura DD_HALINFO quando viene chiamata la funzione DrvGetDirectDrawInfo del driver per inizializzare il componente DirectDraw del driver.