Microsoft SDK for Java

createExecuteBuffer

This method of the Direct3dDevice Class allocates an execute buffer for a display list. The list can be read by hardware DMA into VRAM for processing. All display primitives in the buffer that have indices to vertices must also have those vertices in the same buffer.

Syntax

public Direct3dExecuteBuffer createExecuteBuffer( D3dExecuteBufferDesc ebufDesc);

Return Value

Returns the Direct3dExecuteBuffer if successful; otherwise, null.

Parameters

ebufDesc Describes the Direct3dExecuteBuffer object to be created. The call will fail if a buffer of at least the specified size cannot be created.

Remarks

The D3dExecuteBufferDesc object describes the execute buffer to be created. At a minimum, the application must specify the size required. If the application specifies DEBCAPS_VIDEO_MEMORY in the capabilities field, Direct3D will attempt to keep the execute buffer in video memory.

The application can use the lock method to request that the memory be moved. When this method returns, it will adjust the contents of the D3dExecuteBufferDesc object to indicate whether the data resides in system or video memory.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.