Funzione D3DXLoadMeshFromXInMemory

Carica una mesh dalla memoria.

Sintassi

HRESULT D3DXLoadMeshFromXInMemory(
  _In_  LPCVOID           Memory,
  _In_  DWORD             SizeOfMemory,
  _Out_ DWORD             Options,
  _In_  LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_ LPD3DXBUFFER      *ppAdjacency,
  _Out_ LPD3DXBUFFER      *ppMaterials,
  _Out_ LPD3DXBUFFER      *ppEffectInstances,
  _Out_ DWORD             *pNumMaterials,
  _Out_ LPD3DXMESH        *ppMesh
);

Parametri

Memoria [in]

Tipo: LPCVOID

Puntatore al buffer di memoria che contiene i dati mesh.

SizeOfMemory [in]

Tipo: DWORD

Dimensioni del file in memoria, in byte.

Opzioni [out]

Tipo: DWORD

Combinazione di uno o più flag dall'enumerazione D3DXMESH , specificando le opzioni di creazione per la mesh.

pD3DDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntatore a un'interfaccia IDirect3DDevice9 , l'oggetto dispositivo associato alla mesh.

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Indirizzo di un puntatore a un'interfaccia ID3DXBuffer . Quando il metodo restituisce, questo parametro viene riempito con una matrice di tre DWORD per viso che specificano i tre vicini per ogni viso nella mesh.

ppMaterials [out]

Tipo: LPD3DXBUFFER*

Indirizzo di un puntatore a un'interfaccia ID3DXBuffer . Quando questo metodo viene restituito, questo parametro viene riempito con una matrice di strutture D3DXMATERIAL , contenenti informazioni salvate nel file DirectX.

ppEffectInstances [out]

Tipo: LPD3DXBUFFER*

Puntatore a un buffer contenente una matrice di istanze di effetto, una per gruppo di attributi nella mesh restituita. Un'istanza dell'effetto è un'istanza specifica di informazioni sullo stato usate per inizializzare un effetto. Vedere D3DXEFFECTINSTANCE. Per altre informazioni sull'accesso al buffer, vedere ID3DXBuffer.

pNumMaterials [out]

Tipo: DWORD*

Puntatore al numero di strutture D3DXMATERIAL nella matrice ppMaterials , quando il metodo restituisce.

ppMesh [out]

Tipo: LPD3DXMESH*

Indirizzo di un puntatore a un'interfaccia ID3DXMesh che rappresenta la mesh caricata.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito è D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei valori seguenti: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Commenti

Tutte le mesh nel file verranno compresse in una mesh di output. Se il file contiene una gerarchia di frame, tutte le trasformazioni verranno applicate alla mesh.

Per i file mesh che non contengono informazioni sull'istanza degli effetti, le istanze di effetto predefinite verranno generate dalle informazioni sul materiale nel file .x. Un'istanza di effetto predefinita avrà valori predefiniti che corrispondono ai membri della struttura D3DMATERIAL9 .

Il nome della trama predefinito viene compilato anche, ma viene gestito in modo diverso. Il nome sarà Texture0@Name, che corrisponde a una variabile di effetto in base al nome "Texture0" con un'annotazione denominata "Name". Questo conterrà il nome del file di stringa per la trama.

Requisiti

Requisito	Valore
Intestazione	D3DX9Mesh.h
Libreria	D3dx9.lib

Vedi anche

Funzioni mesh

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE