Funzione D3DXLoadMeshFromXResource
Carica una mesh da una risorsa.
Sintassi
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
);
Parametri
-
Modulo [in]
-
Tipo: HMODULE
Gestire il modulo in cui si trova la risorsa o NULL per il modulo associato all'immagine usata per creare il processo corrente. Vedere la sezione Osservazioni.
-
Nome [in]
-
Tipo: LPCSTR
Puntatore a una stringa che specifica la risorsa da cui creare la mesh. Vedere la sezione Osservazioni.
-
Tipo [in]
-
Tipo: LPCSTR
Puntatore a una stringa che specifica il tipo di risorsa. Vedere la sezione Osservazioni.
-
Opzioni [in]
-
Tipo: DWORD
Combinazione di uno o più flag dell'enumerazione D3DXMESH che specificano 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 termina, 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 termina, 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 ogni gruppo di attributi nella mesh restituita. Un'istanza dell'effetto è una particolare istanza delle informazioni sullo stato utilizzate 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 viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei valori seguenti: D3DERR_INVALIDCALL, E_OUTOFMEMORY.
Commenti
Per altre informazioni sui parametri Module, Name e Type, vedere FindResource .
Tutte le mesh nel file verranno compresse in un'unica 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 dell'effetto, le istanze dell'effetto predefinite verranno generate dalle informazioni sul materiale nel file con estensione x. Un'istanza dell'effetto predefinita avrà valori predefiniti che corrispondono ai membri della struttura D3DMATERIAL9 .
Il nome predefinito della trama viene compilato anche, ma viene gestito in modo diverso. Il nome sarà Texture0@Name, che corrisponde a una variabile di effetto con il nome di "Texture0" con un'annotazione denominata "Name". Questo conterrà il nome del file stringa per la trama.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche