Edit

D3DHAL_DP2ADDDIRTYBOX structure (d3dhal.h)

  • Article

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)

See also

D3DHAL_DP2COMMAND

D3DHAL_DP2OPERATION

DDCORECAPS

DD_HALINFO

DrvGetDirectDrawInfo