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	D3DX9Mesh.h
Libreria	D3dx9.lib

Vedi anche

Funzioni mesh

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE