Microsoft DirectX 8.0 (C++)

IDirect3DVolumeTexture8::AddDirtyBox

Adds a dirty region to a volume texture resource.

HRESULT AddDirtyBox(
  CONST D3DBOX* pDirtyBox
);

Parameters

pDirtyBox
[in] Pointer to a D3DBOX structure, specifying the dirty region to add. Specifying NULL expands the dirty region to cover the entire volume texture.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

Applications can optimize what subset of a resource is copied by specifying boxes on the resource. However, the dirty regions may be expanded to optimize alignment.

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.