D3DXCreateMesh

Creates a mesh object using a declarator.

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

Parameters

NumFaces

[in] Number of faces for the mesh. The valid range for this number is greater than 0, and one less than the maximum DWORD (typically 65534), because the last index is reserved.

NumVertices

[in] Number of vertices for the mesh. This parameter must be greater than 0.

Options

[in] Combination of one or more flags from the D3DXMESH enumeration, specifying options for the mesh.

pDeclaration

[in] Array of D3DVERTEXELEMENT9 elements, describing the vertex format for the returned mesh. This parameter must map directly to a flexible vertex format (FVF).

pD3DDevice

[in] Pointer to an IDirect3DDevice9 interface, the device object to be associated with the mesh.

ppMesh

[out] Address of a pointer to an ID3DXMesh interface, representing the created mesh object.

Return Values

If the function succeeds, the return value is D3D_OK. If the function fails, the return value can be one of the following: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Requirements

Header: Declared in D3dx9mesh.h.

See Also

D3DXDeclaratorFromFVF