D3DXCreateVolumeTextureFromResourceEx fonction)

Crée une texture de volume à partir d’une ressource spécifiée par une chaîne. Il s’agit d’une fonction plus avancée que D3DXCreateVolumeTextureFromResource.

Syntaxe

HRESULT D3DXCreateVolumeTextureFromResourceEx(
  _In_    LPDIRECT3DDEVICE9        pDevice,
  _In_    HMODULE                  hSrcModule,
  _In_    LPCTSTR                  pSrcResource,
  _In_    UINT                     Width,
  _In_    UINT                     Height,
  _In_    UINT                     Depth,
  _In_    UINT                     MipLevels,
  _In_    DWORD                    Usage,
  _In_    D3DFORMAT                Format,
  _In_    D3DPOOL                  Pool,
  _In_    DWORD                    Filter,
  _In_    DWORD                    MipFilter,
  _In_    D3DCOLOR                 ColorKey,
  _Inout_ D3DXIMAGE_INFO           *pSrcInfo,
  _Out_   PALETTEENTRY             *pPalette,
  _Out_   LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

Paramètres

pDevice [ dans]

Type : LPDIRECT3DDEVICE9

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

hSrcModule [ dans]

Type : HMODULE

Handle vers le module dans lequel se trouve la ressource, ou null pour le module associé à l’image que le système d’exploitation a utilisé pour créer le processus actuel.

pSrcResource [ dans]

Type : LPCTSTR

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

Largeur [ dans]

Type : uint

Largeur en pixels. Si cette valeur est égale à zéro ou _ à D3DX default, les dimensions sont extraites du fichier. La dimension maximale prise en charge par un pilote (pour la largeur, la hauteur et la profondeur) est disponible dans MaxVolumeExtent dans D3DCAPS9.

Hauteur [ dans]

Type : uint

Hauteur, en pixels. Si cette valeur est égale à zéro ou _ à D3DX default, les dimensions sont extraites du fichier. La dimension maximale prise en charge par un pilote (pour la largeur, la hauteur et la profondeur) est disponible dans MaxVolumeExtent dans D3DCAPS9.

Profondeur [ dans]

Type : uint

Profondeur, en pixels. Si cette valeur est égale à zéro ou _ à D3DX default, les dimensions sont extraites du fichier. La dimension maximale prise en charge par un pilote (pour la largeur, la hauteur et la profondeur) est disponible dans MaxVolumeExtent dans D3DCAPS9.

Miplevels a [ dans]

Type : uint

Nombre de niveaux MIP demandés. Si cette valeur est égale à zéro ou à D3DX _ default, une chaîne mipmap complète est créée.

Utilisation [ dans]

Type : DWORD

0, D3DUSAGE _ RENDERTARGET ou D3DUSAGE _ dynamique. L’affectation de la valeur D3DUSAGE RENDERTARGET à cet indicateur _ indique que la surface doit être utilisée comme cible de rendu. La ressource peut ensuite être transmise au paramètre pNewRenderTarget de la méthode SetRenderTarget . Si D3DUSAGE _ RENDERTARGET ou D3DUSAGE _ Dynamic est spécifié, pool doit avoir la valeur D3DPOOL _ Default et l’application doit vérifier que l’appareil prend en charge cette opération en appelant CheckDeviceFormat. D3DUSAGE _ Dynamic indique que la surface doit être gérée dynamiquement. Pour plus d’informations sur l’utilisation des textures dynamiques, consultez utilisation de textures dynamiques.

Format [ dans]

Type : D3DFORMAT

Membre du type énuméré D3DFORMAT , décrivant le format de pixel demandé pour la texture. La texture retournée peut avoir un format différent de celui spécifié par le format. Les applications doivent vérifier le format de la texture retournée. Si D3DFMT est _ inconnu, le format est extrait du fichier. Si D3DFMT _ à partir d' _ un fichier, le format est pris exactement comme dans le fichier, et l’appel échoue si cela ne respecte pas les fonctionnalités de l’appareil.

Pool [ dans]

Type : D3DPOOL

Membre du type énuméré D3DPOOL , décrivant la classe de mémoire dans laquelle la texture doit être placée.

Filtre [ dans]

Type : DWORD

Combinaison d’un ou de plusieurs _ filtres D3DX contrôlant la façon dont l’image est filtrée. La spécification _ de la valeur D3DX par défaut pour ce paramètre revient à spécifier la valeur de filtre du _ triangle de filtre D3DX _ | _ _ .

MipFilter [ dans]

Type : DWORD

Combinaison d’un ou de plusieurs _ filtres D3DX contrôlant la façon dont l’image est filtrée. La spécification _ de D3DX par défaut pour ce paramètre est l’équivalent de la spécification de la _ zone de filtre D3DX _ .

ColorKey [ dans]

Type : D3DCOLOR

Valeur D3DCOLOR à remplacer par le noir transparent, ou 0 pour désactiver le ColorKey. Il s’agit toujours d’une couleur ARVB de 32 bits, indépendante du format d’image source. Alpha est significatif et doit généralement être défini sur FF pour les clés de couleur opaques. Ainsi, pour le noir opaque, la valeur est égale à 0xFF000000.

pSrcInfo [ in, out]

Type : D3DXIMAGE _ info*

Pointeur vers une structure d' _ informations D3DXIMAGE à remplir avec une description des données dans le fichier image source, ou null.

pPalette [ à]

Type : PaletteEntry*

Pointeur vers une structure PaletteEntry qui représente une palette de couleurs 256 à remplir, ou null.

ppVolumeTexture [ à]

Type : LPDIRECT3DVOLUMETEXTURE9*

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

Valeur retournée

Type : HRESULT

Si la fonction est réussie, 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 _ sera déplacé, E _ OUTOFMEMORY.

Remarques

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 D3DXCreateVolumeTextureFromResourceExW. Dans le cas contraire, l’appel de fonction est résolu en D3DXCreateVolumeTextureFromResourceExA, car les chaînes ANSI sont utilisées.

La ressource en cours de chargement doit être une ressource définie par l’application (RT _ RCDATA).

Cette fonction prend en charge les formats de fichier suivants : .bmp,. DDS,. dib,. HDR, .jpg,. PFM, .png,. ppm et. tga. Consultez D3DXIMAGE _ FILEFORMAT.

Configuration requise

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

Voir aussi

D3DXCreateVolumeTextureFromFile

D3DXCreateVolumeTextureFromFileEx

D3DXCreateVolumeTextureFromFileInMemory

D3DXCreateVolumeTextureFromFileInMemoryEx

D3DXCreateVolumeTextureFromResource

Fonctions de texture dans D3DX 9