Radeon ProRender

rifContextExecuteCommandQueue

Starts the execution of the command_queue object associated with context. All the filters in queue are not guaranteed to complete execution by the time this function returns. See rifFlushQueue, rifSyncronizeQueue.

rif_int rifContextExecuteCommandQueue( rif_context context,
  rif_command_queue command_queue,
  rif_exec_command_queue_callback executionFinishedCallbackFunction,
  void* data,
  float* time);

Parameters

Parameter Input/Output Description
context input a valid rif_context object.
command_queue input The pointer to rif_command_queue object to execute.
executionFinishedCallbackFunction input The user callback function which will be called after command queue execution started. executionFinishedCallbackFunction can be nullptr.
data input The user data which will be passed to executionFinishedCallbackFunction.
time input If not nullptr, will activate profiling and will store execution time. Must be initialized to 0 by user.

Return

Returns RIF_SUCCESS if the command queue is executed successfully. Otherwise, it returns one of the following errors.

Errors

Possible error codes:

  • RIF_ERROR_INVALID_CONTEXT - context is not a valid context object.
  • RIF_ERROR_INVALID_QUEUE - command_queue is not a valid command queue object.
  • RIF_ERROR_INTERNAL_ERROR - an internal error occurs. Sends a bug report if such an error occurs.