D3DHAL_DP2ADDDIRTYBOX structure (d3dhal.h)
DirectX 8.1 and later versions only.
D3DHAL_DP2ADDDIRTYBOX is used to specify that a portion of a 3D resource--a volume texture--was dirtied in system memory. Therefore, this volume must be reloaded into video memory before being used.
Syntax
typedef struct _D3DHAL_DP2ADDDIRTYBOX {
DWORD dwSurface;
D3DBOX DirtyBox;
} D3DHAL_DP2ADDDIRTYBOX;
Members
dwSurface
Specifies the handle to the managed 3D resource that contains a dirtied volume texture.
DirtyBox
Specifies the volume texture that was marked as dirtied. This is a D3DBOX structure, which is described in the Microsoft Windows SDK documentation.
Remarks
D3DHAL_DP2ADDDIRTYBOX, along with the DP2OP_ADDDIRTYBOX token, is used only for driver managed resources. D3DHAL_DP2ADDDIRTYBOX is never sent unless the driver indicates that it manages resources. To indicate that it manages resources, the driver must set the DDCAPS2_CANMANAGERESOURCE bit, in addition to the DDCAPS2_CANMANAGETEXTURE bit, in the dwCaps2 member of a DDCORECAPS structure. The driver specifies this DDCORECAPS structure in the ddCaps member of a DD_HALINFO structure when the driver's DrvGetDirectDrawInfo function is called to initialize the DirectDraw component of the driver.
Requirements
| Requirement | Value |
|---|---|
| Header | d3dhal.h (include D3dhal.h) |