D3DXCreateTextureFromFileInMemory, fonction

Crée une texture à partir d’un fichier en mémoire.

Syntaxe

HRESULT D3DXCreateTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  LPCVOID            pSrcData,
  _In_  UINT               SrcDataSize,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Paramètres

pDevice [in]

Type : LPDIRECT3DDEVICE9

Pointeur vers une interface IDirect3DDevice9 représentant l’appareil à associer à la texture.

pSrcData [in]

Type : LPCVOID

Pointeur vers le fichier en mémoire à partir duquel créer la texture.

SrcDataSize [in]

Type : UINT

Taille en octets du fichier en mémoire.

ppTexture [out]

Type : LPDIRECT3DTEXTURE9*

Adresse d’un pointeur vers une interface IDirect3DTexture9 représentant l’objet de texture créé.

Valeur retournée

Type : HRESULT

Si la fonction réussit, la valeur de retour est D3D_OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Notes

La fonction est équivalente à D3DXCreateTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppTexture).

Cette fonction prend en charge les formats de fichier suivants : .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm et .tga. Voir D3DXIMAGE_FILEFORMAT.

Notez qu’une ressource créée avec cette fonction lorsqu’elle est appelée à partir d’un objet IDirect3DDevice9 est placée dans la classe de mémoire indiquée par D3DPOOL_MANAGED. Lorsque cette méthode est appelée à partir d’un objet IDirect3DDevice9Ex, la ressource est placée dans la classe mémoire désignée par D3DPOOL_DEFAULT.

Le filtrage est automatiquement appliqué à une texture créée à l’aide de cette méthode. Le filtrage équivaut à D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER dans D3DX_FILTER.

Spécifications

Condition requise	Valeur
En-tête	D3dx9tex.h
Bibliothèque	D3dx9.lib

Voir aussi

D3DXCreateTextureFromFileInMemoryEx

Fonctions de texture dans D3DX 9