D3DXCreateVolumeTextureFromFile

Creates a volume texture from a file.

HRESULT D3DXCreateVolumeTextureFromFile(
  LPDIRECT3DDEVICE8         pDevice,
  LPCTSTR                   pSrcFile,
  LPDIRECT3DVOLUMETEXTURE8* ppVolumeTexture
);

Parameters

pDevice

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

pSrcFile

[in] Pointer to a string that specifies the file from which to create the volume texture.

ppVolumeTexture

[out] Address of a pointer to an IDirect3DVolumeTexture8 interface, representing the created texture object.

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

This function supports the following file formats: .bmp, .dds, .dib, .jpg, .png, and .tga.

Mipmapped textures automatically have each level filled with the loaded texture.

When loading images into mipmapped textures, some devices are unable to go to a 1x1 image and this function will fail. If this happens, then the images need to be loaded manually.

This functions supports both Unicode and ANSI strings.

Note that a resource created with this function will be placed in the memory class denoted by D3DPOOL_MANAGED.

Requirements

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

See Also

D3DXCreateVolumeTextureFromFileEx, D3DXCreateVolumeTextureFromResource, D3DXCreateVolumeTextureFromResourceEx, D3DXCreateVolumeTextureFromFileInMemory, D3DXCreateVolumeTextureFromFileInMemoryEx