IDirect3DDevice::Execute

The IDirect3DDevice::Execute method executes a buffer.

HRESULT Execute(

LPDIRECT3DEXECUTEBUFFER lpDirect3DExecuteBuffer,

LPDIRECT3DVIEWPORT lpDirect3DViewport,

DWORD dwFlags

);

Parameters

lpDirect3DExecuteBuffer

Address of the execute buffer to be executed.

lpDirect3DViewport

Address of the Direct3DViewport object that describes the transformation context into which the execute buffer will be rendered.

dwFlags

Flags specifying whether or not objects in the buffer should be clipped. This parameter must be one of the following values:

D3DEXECUTE_CLIPPED
  Clip any primitives in the buffer that are outside or partially outside the viewport.
D3DEXECUTE_UNCLIPPED
  All primitives in the buffer are contained within the viewport.

Return Values

If the method succeeds, the return value is D3D_OK.

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in ddraw.h.
  Import Library: Use ddraw.lib.

See Also

D3DEXECUTEDATA, D3DINSTRUCTION, IDirect3DExecuteBuffer::Validate