nngxStopCmdlistSave Function

NNGX_APICALL void NNGX_APIENTRY nngxStopCmdlistSave(
     GLuint * bufferoffset,
     GLsizei * buffersize,
     GLuint * requestid,
     GLsizei * requestsize
);

	Name	Description
out	bufferoffset	Offset (in bytes) to the address where you started saving the 3D command buffer
out	buffersize	Number of bytes saved in the 3D command buffer
out	requestid	ID at which you started saving command requests
out	requestsize	Number of command requests saved

No values are returned.

Stops saving command list objects.

Stops saving the current command list object. When you stop saving, information is returned as follows: bufferoffset is the offset (in bytes) to the address at which you started saving the 3D command buffer; buffersize is the number of bytes saved in the 3D command buffer; requestid is the ID at which you started saving command requests; and requestsize is the number of command requests saved. Reuse command lists with this information.

The offset (in bytes) to the address at which saving began is returned in bufferoffset. Add this offset to the starting address of the 3D command buffer to find the actual address at which the 3D command buffer started being saved. To get the starting address of the 3D command buffer maintained by the command list that is currently bound, call nngxGetCmdlistParameteri with pname set to NN_GX_CMDLIST_TOP_BUFADDR.

Calling this function does not cause a split command to be generated in the 3D command buffer. Call nngxSplitDrawCmdlist explicitly if a split command is required. Command requests for 3D execution commands may not be saved at all if the 3D command buffer has not been split. If the 3D command buffer does not have any split commands, you must copy it in order to reuse commands.

Calls to this function sometimes cause dummy commands to be generated in the 3D command buffer for padding.

This function generates the following errors.

GL_ERROR_8036_DMP	Saving the command list has not started.

2010/03/12

Initial version.