D3DXCreateMesh-Funktion

Erstellt ein Gitterobjekt mithilfe eines Deklarators.

Syntax

HRESULT D3DXCreateMesh(
  _In_        DWORD               NumFaces,
  _In_        DWORD               NumVertices,
  _In_        DWORD               Options,
  _In_  const LPD3DVERTEXELEMENT9 *pDeclaration,
  _In_        LPDIRECT3DDEVICE9   pD3DDevice,
  _Out_       LPD3DXMESH          *ppMesh
);

Parameter

NumFaces [in]

Typ: DWORD

Anzahl der Gesichter für das Gitter. Der gültige Bereich für diese Zahl ist größer als 0 und einer kleiner als der maximale DWORD-Wert (in der Regel 65534), da der letzte Index reserviert ist.

NumVertices [in]

Typ: DWORD

Anzahl der Scheitelpunkte für das Gitter. Dieser Parameter muss größer als 0 sein.

Optionen [in]

Typ: DWORD

Kombination eines oder mehrerer Flags aus der D3DXMESH-Enumeration , die Optionen für das Gitter angibt.

pDeclaration [in]

Typ: const LPD3DVERTEXELEMENT9*

Array von D3DVERTEXELEMENT9-Elementen , die das Scheitelpunktformat für das zurückgegebene Gitter beschreiben. Dieser Parameter muss direkt einem flexiblen Vertexformat (FVF) zugeordnet werden.

pD3DDevice [in]

Typ: LPDIRECT3DDEVICE9

Zeiger auf eine IDirect3DDevice9-Schnittstelle , das dem Gitter zuzuordnende Geräteobjekt.

ppMesh [out]

Typ: LPD3DXMESH*

Adresse eines Zeigers auf eine ID3DXMesh-Schnittstelle , die das erstellte Gitterobjekt 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, E_OUTOFMEMORY.

Anforderungen

Siehe auch

Gitterfunktionen

D3DXDeclaratorFromFVF