nngxRunCmdlist Function

NNGX_APICALL void NNGX_APIENTRY nngxRunCmdlist(
     void
);

None.

No values are returned.

Runs the current command list.

Sequentially runs the commands accumulated in the current command list. Calls to this function are ignored when 0 is bound to the current command list. Calls to this function are ignored when the command list is running and other command-list objects are bound to the current list. Commands can be accumulated in a command list that is running.

Calls to this function are ignored when it has been called after the nngxStopCmdlistfunction has been specified to stop commands but before all issued commands have stopped. To confirm that all issued commands have completed, call the nngxGetCmdlistParameteri function and specify NN_GX_CMDLIST_IS_RUNNING for pname, or use the nngxWaitCmdlistDone function to wait until the commands complete.

This API function calls a system process in order to start command execution and blocks all other execution until that process completes. If there are no command requests, this process is called when a function used to add a command request to the start is called, not at the point this function is called. (The same is true when a command request being executed is emptied and then added anew.)

This function generates the following errors.

GL_ERROR_8009_DMP	The bound command list does not have a region allocated for the command buffer or a command request.

nngxStopCmdlist
nngxWaitCmdlistDone

2011/11/29

Added information about the timing of execution blocking caused by calling this function.

2011/10/04

Added See Also section.

2010/10/07

Added a method for verifying that issued commands have finished running.

2010/03/12

Added extended error codes.

2010/01/07

Initial version.