CPixel::ComputeMipVolumeOffset method

The CPixel::ComputeMipVolumeOffset method determines the subvolume offset of a mipmap volume texture.

Syntax

static void  ComputeMipVolumeOffset(
   const D3DVOLUME_DESC *pDescTopLevel,
         UINT           iLevel,
         BYTE           *pBits,
   const D3DBOX         *pBox,
   const D3DLOCKED_BOX  *pLockedBoxData
);

Parameters

pDescTopLevel Pointer to a D3DVOLUME_DESC structure that describes the top level of the mipmap texture volume.

iLevel Specifies the level of the mipmap volume where the offset is determined.

pBits Pointer to the beginning of the top level of the mipmap volume texture or NULL if the caller only requires the offset.

pBox Pointer to a D3DBOX structure that describes the subvolume or NULL if the caller only requires the beginning of the sublevel.

pLockedBoxData Pointer to a D3DLOCKED_BOX structure that receives the pointer or offset to the locked volume region.

Return value

None

Remarks

Given the surface description, the level of the mipmap volume, a pointer to the top level, and the subvolume, CPixel::ComputeMipVolumeOffset returns a pointer or offset to the locked box region in the pBits member of the D3DLOCKED_BOX structure at pLockedBoxData.

For more information about D3DLOCKED_BOX, D3DVOLUME_DESC, and D3DBOX, see the Microsoft DirectX SDK documentation.

Requirements