?/TD>
Microsoft DirectX 9.0

D3DXCreateMesh Function


Creates a mesh object using a declarator.

Syntax

HRESULT D3DXCreateMesh(      

    DWORD NumFaces,     DWORD NumVertices,     DWORD Options,     CONST LPD3DVERTEXELEMENT9 *pDeclaration,     LPDIRECT3DDEVICE9 pDevice,     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).
pDevice
[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 Value

If the function succeeds, the return value is D3D_OK.

If the function fails, the return value can be one of the following values.

D3DERR_INVALIDCALLThe method call is invalid. For example, a method's parameter may have an invalid value.
E_OUTOFMEMORYMicrosoft?Direct3D?could not allocate sufficient memory to complete the call.


Function Information

Headerd3dx9mesh.h
Import libraryd3dx9.lib
Minimum operating systems Windows 98

See Also

D3DXDeclaratorFromFVF


© 2002 Microsoft Corporation. All rights reserved.