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) |