D3DXCheckVolumeTextureRequirements

Checks volume-texture-creation parameters.

HRESULT D3DXCheckVolumeTextureRequirements(
  LPDIRECT3DDEVICE8 pDevice,
  UINT* pWidth,
  UINT* pHeight,
  UINT* pDepth,
  UINT* pNumMipLevels,
  DWORD Usage,
  D3DFORMAT* pFormat,
  D3DPOOL Pool
);

Parameters

pDevice

[in] Pointer to an IDirect3DDevice8 interface, representing the device to be associated with the volume texture.

pWidth

[in, out] Pointer to the requested width in pixels, or NULL. Returns the corrected size.

pHeight

[in, out] Pointer to the requested height in pixels, or NULL. Returns the corrected size.

pDepth

[in, out] Pointer to the requested depth in pixels, or NULL. Returns the corrected size.

pNumMipLevels

[in, out] Pointer to the number of requested mipmap levels, or NULL. Returns the corrected number of mipmap levels.

Usage

[in] Currently not used, set to 0.

pFormat

[in, out] Pointer to a member of the D3DFORMAT enumerated type. Specifies the desired pixel format, or NULL. Returns the corrected format.

Pool

[in] Member of the D3DPOOL enumerated type, describing the memory class into which the volume texture should be placed.

Return Values

If the function succeeds, the return value is D3D_OK.

If the function fails, the return value can be one of the following values.

Remarks

If parameters to this function are invalid, this function returns corrected parameters.

Requirements

  Header: Declared in D3dx8tex.h.
  Import Library: Use D3dx8.lib.