PFND3DDDI_DRAWPRIMITIVE callback function

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

Target platform

Desktop

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: