D3DXCreateTextureFromFileInMemory
Microsoft DirectX 9.0 SDK Update (October 2004)

D3DXCreateTextureFromFileInMemory Function


Creates a texture from a file in memory.

Syntax

HRESULT WINAPI D3DXCreateTextureFromFileInMemory(      

    LPDIRECT3DDEVICE9 pDevice,     LPCVOID pSrcData,     UINT SrcDataSize,     LPDIRECT3DTEXTURE9 *ppTexture );

Parameters

pDevice
[in] Pointer to an IDirect3DDevice9 interface representing the device to be associated with the texture.
pSrcData
[in] Pointer to the file in memory from which to create the texture.
SrcDataSize
[in] Size in bytes of the file in memory.
ppTexture
[out] Address of a pointer to an IDirect3DTexture9 interface representing the created texture object.

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:

D3DERR_NOTAVAILABLEThis device does not support the queried technique.
D3DERR_OUTOFVIDEOMEMORYMicrosoft Direct3D does not have enough display memory to perform the operation.
D3DERR_INVALIDCALLThe method call is invalid. For example, a method's parameter may have an invalid value.
D3DXERR_INVALIDDATAThe data is invalid.
E_OUTOFMEMORYDirect3D could not allocate sufficient memory to complete the call.


Remarks

This function supports the following file formats: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm, and .tga. See D3DXIMAGE_FILEFORMAT.

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

Function Information

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

See Also

D3DXCreateTextureFromFileInMemoryEx, Texture Support in D3DX


© 2004 Microsoft Corporation. All rights reserved.
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center.