Fonction D3DXLoadPatchMeshFromXof

Charge un maillage de correctif à partir d’un objet ID3DXFileData .

Syntaxe

HRESULT D3DXLoadPatchMeshFromXof(
  _In_  LPD3DXFILEDATA    pxofMesh,
  _In_  DWORD             Options,
  _In_  LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_ LPD3DXBUFFER      *ppMaterials,
  _Out_ LPD3DXBUFFER      *ppEffectInstances,
  _Out_ PDWORD            pNumMaterials,
  _Out_ LPD3DXPATCHMESH   *ppMesh
);

Paramètres

pxofMesh [in]

Type : LPD3DXFILEDATA

Pointeur vers une interface ID3DXFileData , représentant l’objet de données de fichier à charger.

Options [in]

Type : DWORD

Combinaison d’un ou de plusieurs indicateurs D3DXMESH , spécifiant des options de création pour le maillage.

pD3DDevice [in]

Type : LPDIRECT3DDEVICE9

Pointeur vers l’appareil à partir duquel le maillage est créé.

ppMaterials [out]

Type : LPD3DXBUFFER*

Tableau de matériaux contenus dans le maillage. Chaque matériau est indexé par une interface ID3DXBuffer .

ppEffectInstances [out]

Type : LPD3DXBUFFER*

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

pNumMaterials [out]

Type : PDWORD

Pointeur qui contient le nombre de matériaux dans le maillage.

ppMesh [out]

Type : LPD3DXPATCHMESH*

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

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_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Notes

Pour les fichiers de maillage qui ne contiennent pas d’informations d’effet instance, les instances d’effet par défaut sont générées à partir des informations matérielles dans le fichier .x. Un effet par défaut instance 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 il est géré différemment. Le nom sera Texture0@Name, qui correspond à une variable d’effet par le nom de « Texture0 » avec une annotation appelée « Name ». Ce fichier 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