D3DXLoadMeshFromXResource fonction)

Charge un maillage à partir d’une ressource.

Syntaxe

HRESULT D3DXLoadMeshFromXResource(
  _In_  HMODULE           Module,
  _In_  LPCSTR            Name,
  _In_  LPCSTR            Type,
  _In_  DWORD             Options,
  _In_  LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_ LPD3DXBUFFER      *ppAdjacency,
  _Out_ LPD3DXBUFFER      *ppMaterials,
  _Out_ LPD3DXBUFFER      *ppEffectInstances,
  _Out_ DWORD             *pNumMaterials,
  _Out_ LPD3DXMESH        *ppMesh
);

Paramètres

Module [ 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. Consultez la section Remarques.

Nom [ dans]

Type : LPCSTR

Pointeur vers une chaîne qui spécifie la ressource à partir de laquelle créer le maillage. Consultez la section Remarques.

Type [ dans]

Type : LPCSTR

Pointeur vers une chaîne qui spécifie le type de ressource. Consultez la section Remarques.

Options [ dans]

Type : DWORD

Combinaison d’un ou plusieurs indicateurs de l’énumération D3DXMESH qui spécifient les options de création du maillage.

pD3DDevice [ dans]

Type : LPDIRECT3DDEVICE9

Pointeur vers une interface IDirect3DDevice9 , l’objet appareil associé à la maille.

ppAdjacency [ à]

Type : LPD3DXBUFFER*

Adresse d’un pointeur vers une interface ID3DXBuffer . Quand la méthode est retournée, ce paramètre est rempli avec un tableau de trois DWORDs par visage qui spécifient les trois voisins pour chaque visage de la maille.

ppMaterials [ à]

Type : LPD3DXBUFFER*

Adresse d’un pointeur vers une interface ID3DXBuffer . Lorsque cette méthode est retournée, ce paramètre est rempli avec un tableau de structures D3DXMATERIAL , contenant les informations enregistrées dans le fichier DirectX.

ppEffectInstances [ à]

Type : LPD3DXBUFFER*

Pointeur vers une mémoire tampon qui contient un tableau d’instances d’effet, une par groupe d’attributs dans le maillage retourné. Une instance Effect est une instance particulière d’informations d’état utilisée pour initialiser un effet. Consultez D3DXEFFECTINSTANCE. Pour plus d’informations sur l’accès à la mémoire tampon, consultez ID3DXBuffer.

pNumMaterials [ à]

Type : DWORD*

Pointeur vers le nombre de structures D3DXMATERIAL dans le tableau ppMaterials , lorsque la méthode retourne.

ppMesh [ à]

Type : LPD3DXMESH*

Adresse d’un pointeur vers une interface ID3DXMesh représentant le maillage chargé.

Valeur de retour

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 valeurs suivantes : D3DERR _ INVALIDCALL, E _ OUTOFMEMORY.

Notes

Consultez FindResource pour en savoir plus sur les paramètres de module, de nom et de type.

Tous les maillages du fichier seront réduits en un seul maillage de sortie. Si le fichier contient une hiérarchie de frames, toutes les transformations sont appliquées à la maille.

Pour les fichiers de maillage qui ne contiennent pas d’informations sur l’instance d’effet, les instances d’effet par défaut sont générées à partir des informations matérielles du fichier. x. Une instance d’effet par défaut aura des valeurs par défaut qui correspondent aux membres de la structure D3DMATERIAL9 .

Le nom de texture par défaut est également renseigné, mais est géré différemment. Le nom est Texture0@Name , ce qui correspond à une variable Effect par le nom de « Texture0 » avec une annotation appelée « Name ». Contient le nom de fichier de chaîne pour la texture.

Spécifications

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

Voir aussi

Fonctions de maillage

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE