Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method renders a sequence of non-indexed, geometric primitives of the specified type from the current set of data input streams.

Syntax 

HRESULT DrawPrimitive(
  D3DMPRIMITIVETYPE 
PrimitiveType,
  UINT 
StartVertex,
  UINT 
PrimitiveCount
);

Parameters

PrimitiveType

[in] Member of the D3DMPRIMITIVETYPEenumerated type that describes the type of primitive to render.

StartVertex

[in] Index of the first vertex to load. Beginning at StartVertexthe correct number of vertices will be read out of the vertex buffer.

PrimitiveCount

[in] Number of primitives to render. The maximum number of primitives allowed is determined by checking the MaxPrimitiveCountmember of the D3DMCAPSstructure. PrimitiveCountis the number of primitives as determined by the primitive type. If it is a line list, each primitive has two vertices. If it is a triangle list, each primitive has three vertices.

Return Value

If the method succeeds, the return value is D3DM_OK (see D3DM Values).

If the method fails, the return value can be D3DMERR_INVALIDCALL (see D3DMERR Values).

Remarks

Do not call this method with a single triangle at a time.

Requirements

Header d3dm.h
Library D3dm.lib, D3dmguid.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also