Microsoft DirectX 9.0

D3DXCheckTextureRequirements Function

Checks texture-creation parameters.


HRESULT D3DXCheckTextureRequirements(      

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


[in] Pointer to an IDirect3DDevice9 interface, representing the device to be associated with the texture.
[in, out] Pointer to the requested width in pixels, or NULL. Returns the corrected size.
[in, out] Pointer to the requested height in pixels, or NULL. Returns the corrected size.
[in, out] Pointer to number of requested mipmap levels, or NULL. Returns the corrected number of mipmap levels.
[in] 0 or D3DUSAGE_RENDERTARGET. Setting this flag to D3DUSAGE_RENDERTARGET indicates that the surface is to be used as a render target. The resource can then be passed to the pNewRenderTarget parameter of the IDirect3DDevice9::SetRenderTargetmethod. If D3DUSAGE_RENDERTARGET is specified, the application should check that the device supports this operation by calling IDirect3D9::CheckDeviceFormat.
[in, out] Pointer to a member of the D3DFORMAT enumerated type. Specifies the desired pixel format, or NULL. Returns the corrected format.
[in] Member of the D3DPOOL enumerated type, describing the memory class into which the 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.


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

Function Information

Import libraryd3dx9.lib
Minimum operating systems Windows 98

© 2002 Microsoft Corporation. All rights reserved.