~~NOTOC~~

====== clReleaseCommandQueue ======

Verringert den Referenzzähler von //command_queue//.

===== Signatur =====

<code cpp>
cl_int clReleaseCommandQueue( cl_command_queue command_queue )
</code>

===== Parameter =====

**command_queue:** Die Command-Queue, die freigelassen werden soll.

===== Rückgabewert =====

Zurückgegeben wird ein Fehlercode:

^ Wert ^ Beschreibung ^
| CL_SUCCESS | Die Funktion wurde erfolgreich ausgeführt |
| CL_INVALID_COMMAND_QUEUE | //command_queue// ist keine gültige Command-Queue |
| CL_OUT_OF_RESOURCES | Es ist ein Fehler beim Reservieren von Speicher aufgetreten, der für die OpenCL-Implementation auf dem Gerät gebraucht wird. |
| CL_OUT_OF_HOST_MEMORY | Es ist ein Fehler beim Reservieren von Speicher aufgetreten, der für die OpenCL-Implementation auf dem Hostprozressor gebraucht wird. |

===== Hinweise =====

Wenn der Referenzzähler von //command_queue// auf Null fällt und alle in ihr enthaltenen Befehle abgearbeitet sind, wird die Command-Queue gelöscht. //clReleaseCommandQueue// führt ein implizites //clFlush// aus um alle vorher eingereihten Befehle auszuführen. 

===== Siehe auch =====

  * [[clflush|clFlush]]
  * [[clfinish|clFinish]]
  * [[clcreatecommandqueue|clCreateCommandQueue]]