D3DXLoadMeshFromXof-Funktion
Lädt ein Gitter aus einem ID3DXFileData-Objekt .
Syntax
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
);
Parameter
-
pxofMesh [in]
-
Typ: LPD3DXFILEDATA
Zeiger auf eine ID3DXFileData-Schnittstelle , die das zu ladende Dateidatenobjekt darstellt.
-
Optionen [out]
-
Typ: DWORD
Kombination aus einem oder mehreren Flags aus der D3DXMESH-Enumeration , die Erstellungsoptionen für das Gitter angibt.
-
pDevice [in]
-
Typ: LPDIRECT3DDEVICE9
Zeiger auf eine IDirect3DDevice9-Schnittstelle , das dem Gitter zugeordnete Geräteobjekt.
-
ppAdjacency [out]
-
Typ: LPD3DXBUFFER*
Zeiger auf einen Puffer, der Adjacency-Daten enthält. Die Adjacency-Daten enthalten ein Array von drei DWORDs pro Gesicht, die die drei Nachbarn für jedes Gesicht im Gitter angeben. Weitere Informationen zum Zugriff auf den Puffer finden Sie unter ID3DXBuffer.
-
ppMaterials [in, out]
-
Typ: LPD3DXBUFFER*
Adresse eines Zeigers auf eine ID3DXBuffer-Schnittstelle . Wenn die Methode zurückgibt, wird dieser Parameter mit einem Array von D3DXMATERIAL-Strukturen gefüllt.
-
ppEffectInstances [out]
-
Typ: LPD3DXBUFFER*
Zeiger auf einen Puffer, der ein Array von Effektinstanzen enthält, eine pro Attributgruppe im zurückgegebenen Gitter. Ein Effekt instance ist ein bestimmter instance von Zustandsinformationen, die zum Initialisieren eines Effekts verwendet werden. Siehe D3DXEFFECTINSTANCE. Weitere Informationen zum Zugriff auf den Puffer finden Sie unter ID3DXBuffer.
-
pNumMaterials [in, out]
-
Typ: DWORD*
Zeiger auf die Anzahl der D3DXMATERIAL-Strukturen im ppMaterials-Array , wenn die Methode zurückgibt.
-
ppMesh [out]
-
Typ: LPD3DXMESH*
Adresse eines Zeigers auf eine ID3DXMesh-Schnittstelle , die das geladene Gitter darstellt.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Bemerkungen
Bei Mesh-Dateien, die keine Effekt- instance Informationen enthalten, werden standardeffektinstanzen aus den Materialinformationen in der X-Datei generiert. Ein Standardeffekt instance Standardwerte aufweist, die den Elementen der D3DMATERIAL9-Struktur entsprechen.
Der Standardtexturname wird ebenfalls ausgefüllt, aber anders behandelt. Der Name wird Texture0@Name, was einer Effektvariable durch den Namen "Texture0" mit einer Anmerkung namens "Name" entspricht. Dies enthält den Zeichenfolgendateinamen für die Textur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch