Blt
Expand Minimize

DrawPrimitive routine

The DrawPrimitive function draws nonindexed primitives in which the Microsoft Direct3D runtime has not transformed the vertex data.

Syntax


PFND3DDDI_DRAWPRIMITIVE DrawPrimitive;

__checkReturn HRESULT  APIENTRY DrawPrimitive(
  _In_  HANDLE hDevice,
  _In_  const D3DDDIARG_DRAWPRIMITIVE *pData,
  _In_  const UINT *pFlagBuffer
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

pData [in]

A pointer to a D3DDDIARG_DRAWPRIMITIVE structure that describes the primitive to draw.

pFlagBuffer [in]

A pointer to a 32-bit value that contains triangle-edge flags, which are used only during line-fill mode. The first three bits (0/1/2) of the 32-bit value specify how the three edges of the corresponding triangles are rendered. If a bit is set to 1, its associated triangle edge is rendered; otherwise, the edge is not rendered.

If the pointer is NULL, the user-mode display driver should use its fast path to draw primitives.

Return value

DrawPrimitive returns S_OK or an appropriate error result if the primitive is not successfully drawn.

Remarks

When the Microsoft Direct3D runtime specifies triangle-edge flags in the value that the pFlagBuffer parameter points to, the runtime also specifies to draw one or more triangles (that is, the runtime specifies the D3DPT_TRIANGLEFAN value in the PrimitiveType member and from 0x00000001 to 0xFFFFFFFF in the PrimitiveCount member of the D3DDDIARG_DRAWPRIMITIVE structure that the pData parameter points to).

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dumddi.h (include D3dumddi.h)

See also

D3DDDIARG_DRAWPRIMITIVE
D3DDDI_DEVICEFUNCS

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft