D3DHAL_DP2ADDDIRTYBOX - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dhal.h
typedef struct _D3DHAL_DP2ADDDIRTYBOX {
DWORD dwSurface;
D3DBOX DirtyBox;
} D3DHAL_DP2ADDDIRTYBOX;
View the official Windows Driver Kit DDI referenceNo description available.
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.
dwSurfaceSpecifies the handle to the managed 3D resource that contains a dirtied volume texture.
DirtyBoxSpecifies the volume texture that was marked as dirtied. This is a D3DBOX structure, which is described in the Microsoft Windows SDK documentation.
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.