Microsoft DirectX 8.1 (Visual Basic)

D3DX8.CheckVolumeTextureRequirements

Checks volume texture creation parameters.

object.CheckVolumeTextureRequirements( _ 
    Device As Direct3DDevice8, _ 
    Width As Long, _ 
    Height As Long, _ 
    Depth As Long, _ 
    NumMipLevels As Long, _ 
    Usage As Long, _ 
    PixelFormat CONST_D3DFORMAT, _ 
    Pool As CONST_D3DPOOL)

Parts

object: Object expression that resolves to a D3DX8 object.
Device: Direct3DDevice8 object representing the device associated with the volume texture.
Width: Requested width in pixels, or ByVal 0. Returns the corrected size.
Height: Requested height in pixels, or ByVal 0. Returns the corrected size.
Depth: Requested depth in pixels, or ByVal 0. Returns the corrected size.
NumMipLevels: Number of requested mipmap levels, or ByVal 0. Returns the corrected number of mipmap levels.
Usage: Currently not used, set to 0.
PixelFormat: Member of the CONST_D3DFORMAT enumeration. Specifies the desired pixel format. Returns the corrected format.
Pool: Member of the CONST_D3DPOOL enumeration, describing the memory class into which the volume texture should be placed.

Error Codes

If the method fails, an error is raised and Err.Number can be set to one of the following values.

D3DERR_INVALIDCALL

D3DERR_NOTAVAILABLE

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

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