Decrements the command_queue reference count.
cl_int clReleaseCommandQueue(cl_command_queue command_queue)After the command_queue reference count becomes zero and all commands queued to command_queue have finished (e.g., kernel executions, memory object updates, etc.), the command-queue is deleted.
clReleaseCommandQueue performs an implicit flush to issue any previously queued OpenCL commands in command_queue.
Using this function to release a reference that was not obtained by creating the object or by calling clRetainCommandQueue causes undefined behavior.
Returns CL_SUCCESS if the function is executed successfully.
Otherwise, it returns one of the following:
-
CL_INVALID_COMMAND_QUEUEifcommand_queueis not a valid command queue. -
CL_OUT_OF_RESOURCESif there is a failure to allocate resources required by the OpenCL implementation on the device. -
CL_OUT_OF_HOST_MEMORYif there is a failure to allocate resources required by the OpenCL implementation on the host.