Funzione D3DXLoadMeshFromXof

Carica una mesh da un oggetto ID3DXFileData .

Sintassi

HRESULT D3DXLoadMeshFromXof(
  _In_    LPD3DXFILEDATA    pxofMesh,
  _Out_   DWORD             Options,
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Out_   LPD3DXBUFFER      *ppAdjacency,
  _Inout_ LPD3DXBUFFER      *ppMaterials,
  _Out_   LPD3DXBUFFER      *ppEffectInstances,
  _Inout_ DWORD             *pNumMaterials,
  _Out_   LPD3DXMESH        *ppMesh
);

Parametri

pxofMesh [in]

Tipo: LPD3DXFILEDATA

Puntatore a un'interfaccia ID3DXFileData che rappresenta l'oggetto dati del file da caricare.

Opzioni [out]

Tipo: DWORD

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

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

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

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Puntatore a un buffer che contiene dati di adiacenza. I dati di adiacenza contengono una matrice di tre DWORD per viso che specificano i tre vicini per ogni viso nella mesh. Per altre informazioni sull'accesso al buffer, vedere ID3DXBuffer.

ppMaterials [in, out]

Tipo: LPD3DXBUFFER*

Indirizzo di un puntatore a un'interfaccia ID3DXBuffer . Al termine del metodo, questo parametro viene riempito con una matrice di strutture D3DXMATERIAL .

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 [in, 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 seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Commenti

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

Vedi anche

Funzioni mesh

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE