IDirect3D7::CreateVertexBuffer

The IDirect3D7::CreateVertexBuffer method creates a vertex buffer object.

HRESULT CreateVertexBuffer(
  LPD3DVERTEXBUFFERDESC    lpVBDesc, 
  LPDIRECT3DVERTEXBUFFER7* lplpD3DVertexBuffer, 
  DWORD dwFlags 
);

Parameters

lpVBDesc

Address of a D3DVERTEXBUFFERDESC structure that describes the format and number of vertices that the vertex buffer receives.

lplpD3DVertexBuffer

Address of a variable to receive a pointer to a IDirect3DVertexBuffer7 interface for the new vertex buffer.

dwFlags

No flags are currently defined for this method. This parameter must be 0.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values:

Remarks

This method was introduced with the IDirect3D3 interface. As part of IDirect3D3, this method accepted a pointer to the legacy IDirect3DVertexBuffer interface and accepted flags in the dwFlags parameter.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.

See Also

IDirect3DVertexBuffer7, Vertex Buffers