IDirect3DDevice8::SetIndices

This method sets index data.

HRESULT SetIndices(
  IDirect3DIndexBuffer8* pIndexData,
  UINT BaseVertexIndex
);

Parameters

  • pIndexData
    [in] Pointer an IDirect3DIndexBuffer8 interface, representing the index data to be set.
  • BaseVertexIndex
    [in] Base value for vertex indices. This value is added to all indices prior to referencing vertex data, defining a starting position in the vertex streams.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

The SetIndices method sets the current index array to an index buffer. The single set of indices is used to index all streams.

The BaseVertexIndex parameter specifies the base value for indices. This base value is added to all indices prior to referencing into the vertex data streams, the result of which is to set a starting position in the vertex data streams. The base vertex index enables multiple indexed primitives to be packed into a single set of vertex data without requiring the indices to be recomputed based on where the corresponding primitive is placed in the vertex data.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3DIndexBuffer8 | IDirect3DDevice8::GetIndices | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.