|Microsoft DirectX 9.0|
Creates a cube texture from a file in memory.
LPDIRECT3DDEVICE9 pDevice, LPCVOID pSrcData, UINT SrcDataSize, LPDIRECT3DCUBETEXTURE9 *ppCubeTexture );
- [in] Pointer to an IDirect3DDevice9 interface, representing the device to be associated with the cube texture.
- [in] Pointer to the file in memory from which to create the cubemap. See Remarks.
- [in] Size of the file in memory, in bytes.
- [out] Address of a pointer to an IDirect3DCubeTexture9 interface, representing the created cube texture object.
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_INVALIDCALL The method call is invalid. For example, a method's parameter may have an invalid value. D3DERR_NOTAVAILABLE This device does not support the queried technique. D3DERR_OUTOFVIDEOMEMORY Microsoft?Direct3D?does not have enough display memory to perform the operation. D3DXERR_INVALIDDATA The data is invalid. E_OUTOFMEMORY Direct3D could not allocate sufficient memory to complete the call.
This function supports the following file formats: .bmp, .dds, .dib, .jpg, .png, and .tga.
Note that a resource created with this function will be placed in the memory class denoted by D3DPOOL_MANAGED.
This method is designed to be used for loading image files stored as RT_RCDATA, which is an application-defined resource (raw data). Otherwise this method will fail.
D3DXCreateCubeTextureFromFileInMemory uses the Microsoft DirectDraw?surface (DDS) file format. The DXTex Tool enables you to generate a cube map from other file formats and save it in the DDS file format.
Header d3dx9tex.h Import library d3dx9.lib Minimum operating systems Windows 98