D3DHAL_DP2LINESTRIP structure (d3dhal.h)

One D3DHAL_DP2LINESTRIP structure is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_LINESTRIP, and is used to render the specified connected line segments.

Syntax

typedef struct _D3DHAL_DP2LINESTRIP {
  WORD wVStart;
} D3DHAL_DP2LINESTRIP, *LPD3DHAL_DP2LINESTRIP;

Members

wVStart

Specifies the index into the vertex buffer containing coordinate data for the initial vertex of the line strip.

Remarks

One D3DHAL_DP2LINESTRIP structure follows the D3DHAL_DP2COMMAND structure in the command buffer.

D3dDrawPrimitives2 should sequentially process a total of (wPrimitiveCount + 1) vertices from the vertex buffer. Starting from the vertex buffer offset, the sequence of lines rendered is (wVStart, wVStart + 1), (wVStart + 1, wVStart + 2), (wVStart + 2, wVStart + 3), ..., (wVStart + (wPrimitiveCount - 1), wVStart + wPrimitiveCount). The value of wPrimitiveCount is specified in the D3DHAL_DP2COMMAND structure.

The following figure shows a portion of a sample command buffer containing a D3DDP2OP_LINESTRIP command and one D3DHAL_DP2LINESTRIP structure. The driver should draw three connected lines using the following four vertices from the vertex buffer: (v[4], v[5]), (v[5], v[6]), (v[6], v[7]).

Figure showing a command buffer with a D3DDP2OP_LINESTRIP command and one D3DHAL_DP2LINESTRIP structure

Requirements

Requirement Value
Header d3dhal.h (include D3dhal.h)

See also

D3DDP2OP_LINESTRIP

D3DHAL_DP2COMMAND

D3dDrawPrimitives2