?/TD>
Microsoft DirectX 9.0

D3DXCheckVolumeTextureRequirements Function


Checks volume-texture-creation parameters.

Syntax

HRESULT D3DXCheckVolumeTextureRequirements(      

    LPDIRECT3DDEVICE9 pDevice,     UINT *pWidth,     UINT *pHeight,     UINT *pDepth,     UINT *pNumMipLevels,     DWORD Usage,     D3DFORMAT *pFormat,     D3DPOOL Pool );

Parameters

pDevice
[in] Pointer to an IDirect3DDevice9 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 Value

If the function succeeds, the return value is D3D_OK.

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

D3DERR_NOTAVAILABLEThis device does not support the queried technique.
D3DERR_INVALIDCALLThe method call is invalid. For example, a method's parameter may have an invalid value.


Remarks

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

Function Information

Headerd3dx9tex.h
Import libraryd3dx9.lib
Minimum operating systems Windows 98


© 2002 Microsoft Corporation. All rights reserved.