D3DXCreateTextureFromResource, fonction

Crée une texture à partir d’une ressource.

Syntaxe

HRESULT D3DXCreateTextureFromResource(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  HMODULE            hSrcModule,
  _In_  LPCTSTR            pSrcResource,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Paramètres

pDevice [in]

Type : LPDIRECT3DDEVICE9

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

hSrcModule [in]

Type : HMODULE

Gérez le module où se trouve la ressource, ou NULL pour le module associé à l’image utilisée par le système d’exploitation pour créer le processus actuel.

pSrcResource [in]

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le nom de la ressource. Si les paramètres du compilateur nécessitent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Sinon, le type de données de chaîne est résolu en LPCSTR. Consultez la section Notes.

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

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXCreateTextureFromResourceW. Sinon, l’appel de fonction est résolu en D3DXCreateTextureFromResourceA, car les chaînes ANSI sont utilisées.

La fonction est équivalente à D3DXCreateTextureFromResourceEx(pDevice, hSrcModule, pSrcResource, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, ppTexture).

La ressource chargée doit être de type RT_BITMAP ou RT_RCDATA. Le type de ressource RT_RCDATA est utilisé pour charger d’autres formats que les bitmaps (tels que .tga, .jpg et .dds).

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

D3DXCreateTextureFromResourceEx

Fonctions de texture dans D3DX 9