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 [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. Consultez la section Remarques.
-
Nom [in]
-
Type : LPCSTR
Pointeur vers une chaîne qui spécifie la ressource à partir de laquelle créer le maillage. Consultez la section Remarques.
-
Type [in]
-
Type : LPCSTR
Pointeur vers une chaîne qui spécifie le type de ressource. Consultez la section Remarques.
-
Options [in]
-
Type : DWORD
Combinaison d’un ou de plusieurs indicateurs de l’énumération D3DXMESH qui spécifient des options de création pour le maillage.
-
pD3DDevice [in]
-
Type : LPDIRECT3DDEVICE9
Pointeur vers une interface IDirect3DDevice9 , l’objet d’appareil associé au maillage.
-
ppAdjacency [out]
-
Type : LPD3DXBUFFER*
Adresse d’un pointeur vers une interface ID3DXBuffer . Lorsque la méthode retourne, ce paramètre est rempli avec un tableau de trois DWORD par visage qui spécifient les trois voisins pour chaque face dans le maillage.
-
ppMaterials [out]
-
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 des informations enregistrées dans le fichier DirectX.
-
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 : DWORD*
Pointeur vers le nombre de structures D3DXMATERIAL dans le tableau ppMaterials , lorsque la méthode retourne.
-
ppMesh [out]
-
Type : LPD3DXMESH*
Adresse d’un pointeur vers une interface ID3DXMesh , 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 valeurs suivantes : D3DERR_INVALIDCALL, E_OUTOFMEMORY.
Notes
Consultez FindResource pour en savoir plus sur les paramètres Module, Name et Type.
Tous les maillages du fichier seront réduits en un seul maillage de sortie. Si le fichier contient une hiérarchie de cadres, toutes les transformations sont appliquées au maillage.
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 |
|
| Bibliothèque |
|
Voir aussi