nngxUseSavedCmdlistNoCacheFlush Function

Syntax

NNGX_APICALL void NNGX_APIENTRY nngxUseSavedCmdlistNoCacheFlush(
     GLuint cmdlist,
     GLuint bufferoffset,
     GLsizei buffersize,
     GLuint requestid,
     GLsizei requestsize,
     GLbitfield statemask
);

Arguments

Name Description
in cmdlist Saved command list
in bufferoffset Save information that was obtained using the nngxStopCmdlistSave function
in buffersize Save information that was obtained using the nngxStopCmdlistSave function
in requestid Save information that was obtained using the nngxStopCmdlistSave function
in requestsize Save information that was obtained using the nngxStopCmdlistSave function
in statemask Specifies a bitwise OR of state flags for which to generate complete commands

Return Values

No values are returned.

Description

Adds saved commands to the current command request. (Does not flush the cache.)

This function provides the same functionality as when calling nngxUseSavedCmdlist using GL_FALSE specified in copycmd. However, this function uses different error codes and does not flush the added 3D command buffer. If you do not need to flush the 3D command buffer to be added when calling nngxUseSavedCmdlist and passing GL_FALSE for copycmd, use of this function instead can eliminate the cost of flushing the cache.

Be sure that the application guarantees that the cache is flushed for the 3D command buffer region to be added.

For information about other parameters and features of this function, see the specifications given for nngxUseSavedCmdlist.

This function generates the following errors.

GL_ERROR_8092_DMP0 is bound to the current command list.
GL_ERROR_8093_DMPInvalid value specified for cmdlist
GL_ERROR_8095_DMPThis function has added saved commands that exceed the maximum size of the current command list’s 3D command buffer and command requests

See Also

nngxStopCmdlistSave
nngxUseSavedCmdlist

Revision History

2011/10/04
Added See Also section.
2011/08/24
Removed GL_ERROR_8094_DMP as the cmdlist parameter now supports the current command list.
2011/07/28
Initial version.

CONFIDENTIAL