D3DXCreateVolumeTextureFromFileInMemory function
Creates a volume texture from a file in memory.
Syntax
HRESULT D3DXCreateVolumeTextureFromFileInMemory(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcFile,
_In_ UINT SrcData,
_Out_ LPDIRECT3DVOLUMETEXTURE9 ppVolumeTexture
);
Parameters
-
pDevice [in]
-
Type: LPDIRECT3DDEVICE9
Pointer to an IDirect3DDevice9 interface, representing the device to be associated with the volume texture.
-
pSrcFile [in]
-
Type: LPCVOID
Pointer to the file in memory from which to create the volume texture.
-
SrcData [in]
-
Type: UINT
Size of the file in memory, in bytes.
-
ppVolumeTexture [out]
-
Type: LPDIRECT3DVOLUMETEXTURE9
Address of a pointer to an IDirect3DVolumeTexture9 interface, representing the created texture object.
Return value
Type: HRESULT
If the function succeeds, the return value is D3D_OK. If the function fails, the return value can be one of the following: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Remarks
This function supports the following file formats: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm, and .tga. See D3DXIMAGE_FILEFORMAT.
The function is equivalent to D3DXCreateVolumeTextureFromFileInMemoryEx(pDevice, pSrcFile, SrcData, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppVolumeTexture).
Note that a resource created with this function when called from a IDirect3DDevice9 object will be placed in the memory class denoted by D3DPOOL_MANAGED. When this method is called from a IDirect3DDevice9Ex object the resource will be placed in the memory class denoted by D3DPOOL_DEFAULT.
Filtering is automatically applied to a texture created using this method. The filtering is equivalent to D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER in D3DX_FILTER.
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|
See also