D3DHAL_DP2ADDDIRTYRECT structure (d3dhal.h)

DirectX 8.1 and later versions only.

D3DHAL_DP2ADDDIRTYRECT is used to specify that a portion of a 2D resource--a 2D texture or cube texture--was dirtied in system memory. Therefore, this 2D texture must be reloaded into video memory before being used.

Syntax

typedef struct _D3DHAL_DP2ADDDIRTYRECT {
  DWORD dwSurface;
  RECTL rDirtyArea;
} D3DHAL_DP2ADDDIRTYRECT;

Members

dwSurface

Specifies the handle to the managed 2D resource that contains a dirtied 2D texture.

rDirtyArea

Specifies the 2D texture that was marked as dirtied. This is a RECTL structure.

Remarks

D3DHAL_DP2ADDDIRTYRECT, along with the DP2OP_ADDDIRTYRECT token, is used only for driver managed resources and surfaces. D3DHAL_DP2ADDDIRTYRECT 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