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 |
|
| Libreria |
|
Vedi anche