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:

QuickInfo

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in d3d.h.
  Import Library: Use ddraw.lib.

See Also

D3DEXECUTEDATA, D3DINSTRUCTION, IDirect3DExecuteBuffer::Validate