diff --git a/api/cl_khr_command_buffer.asciidoc b/api/cl_khr_command_buffer.asciidoc index a97e067d..9b558be2 100644 --- a/api/cl_khr_command_buffer.asciidoc +++ b/api/cl_khr_command_buffer.asciidoc @@ -4,7 +4,7 @@ include::{generated}/meta/{refprefix}cl_khr_command_buffer.txt[] // *Revision*:: -// 0.9.5 +// 0.9.6 // *Extension and Version Dependencies*:: // This extension requires OpenCL 1.2 or later. // Buffering of SVM commands requires OpenCL 2.0 or later. @@ -12,7 +12,7 @@ include::{generated}/meta/{refprefix}cl_khr_command_buffer.txt[] === Other Extension Metadata *Last Modified Date*:: - 2024-07-24 + 2024-10-02 *IP Status*:: No known IP claims. *Contributors*:: @@ -224,11 +224,11 @@ features: * {cl_device_info_TYPE} ** {CL_DEVICE_COMMAND_BUFFER_CAPABILITIES_KHR} ** {CL_DEVICE_COMMAND_BUFFER_REQUIRED_QUEUE_PROPERTIES_KHR} + ** {CL_DEVICE_COMMAND_BUFFER_SUPPORTED_QUEUE_PROPERTIES_KHR} * {cl_device_command_buffer_capabilities_khr_TYPE} ** {CL_COMMAND_BUFFER_CAPABILITY_KERNEL_PRINTF_KHR} ** {CL_COMMAND_BUFFER_CAPABILITY_DEVICE_SIDE_ENQUEUE_KHR} ** {CL_COMMAND_BUFFER_CAPABILITY_SIMULTANEOUS_USE_KHR} - ** {CL_COMMAND_BUFFER_CAPABILITY_OUT_OF_ORDER_KHR} * {cl_command_buffer_properties_khr_TYPE} ** {CL_COMMAND_BUFFER_FLAGS_KHR} * {cl_command_buffer_flags_khr_TYPE} @@ -438,4 +438,5 @@ features: * 0.9.5, 2024-07-24 ** Add a properties parameter to all command recording entry-points (provisional). - + * 0.9.6, 2024-10-02 + ** Add device query for supported queue properties (provisional). diff --git a/api/opencl_platform_layer.asciidoc b/api/opencl_platform_layer.asciidoc index 81f08b58..19b0ac96 100644 --- a/api/opencl_platform_layer.asciidoc +++ b/api/opencl_platform_layer.asciidoc @@ -1718,12 +1718,6 @@ include::{generated}/api/version-notes/CL_COMMAND_BUFFER_CAPABILITY_DEVICE_SIDE_ include::{generated}/api/version-notes/CL_COMMAND_BUFFER_CAPABILITY_SIMULTANEOUS_USE_KHR.asciidoc[] - {CL_COMMAND_BUFFER_CAPABILITY_OUT_OF_ORDER_KHR_anchor} Device - supports the ability to record command-buffers to out-of-order - command-queues. - -include::{generated}/api/version-notes/CL_COMMAND_BUFFER_CAPABILITY_OUT_OF_ORDER_KHR.asciidoc[] - ifdef::cl_khr_command_buffer_multi_device[] {CL_COMMAND_BUFFER_CAPABILITY_MULTIPLE_QUEUE_KHR_anchor} Device supports the ability to record commands to more than one @@ -1742,6 +1736,18 @@ include::{generated}/api/version-notes/CL_DEVICE_COMMAND_BUFFER_REQUIRED_QUEUE_P It is valid for a command-queue to be created with extra properties in addition to this base requirement and still be compatible with command-buffer execution. + +| {CL_DEVICE_COMMAND_BUFFER_SUPPORTED_QUEUE_PROPERTIES_KHR_anchor} + +include::{generated}/api/version-notes/CL_DEVICE_COMMAND_BUFFER_SUPPORTED_QUEUE_PROPERTIES_KHR.asciidoc[] + + | {cl_command_queue_properties_TYPE} + | Bitmask of the supported properties with which a command-queue may be + created to allow a command-buffer to be executed on it. It is invalid + for a command-queue to be created with a property not reported and + still be compatible with command-buffer execution. + + The mandated minimum capability is: {CL_QUEUE_PROFILING_ENABLE}. endif::cl_khr_command_buffer[] ifdef::cl_khr_command_buffer_multi_device[] diff --git a/api/opencl_runtime_layer.asciidoc b/api/opencl_runtime_layer.asciidoc index e91c1e78..e35e8807 100644 --- a/api/opencl_runtime_layer.asciidoc +++ b/api/opencl_runtime_layer.asciidoc @@ -14178,10 +14178,9 @@ returned in _errcode_ret_: * {CL_INVALID_COMMAND_QUEUE} if any command-queue in _queues_ is not a valid command-queue. - * {CL_INCOMPATIBLE_COMMAND_QUEUE_KHR} if any command-queue in _queues_ is - an out-of-order command-queue and the device associated with the - command-queue does not support the - {CL_COMMAND_BUFFER_CAPABILITY_OUT_OF_ORDER_KHR} capability. + * {CL_INCOMPATIBLE_COMMAND_QUEUE_KHR} if the properties of any command-queue + in _queues_ contains a property not specified by + {CL_DEVICE_COMMAND_BUFFER_SUPPORTED_QUEUE_PROPERTIES_KHR}. * {CL_INCOMPATIBLE_COMMAND_QUEUE_KHR} if the properties of any command-queue in _queues_ does not contain the minimum properties specified by {CL_DEVICE_COMMAND_BUFFER_REQUIRED_QUEUE_PROPERTIES_KHR}. diff --git a/xml/cl.xml b/xml/cl.xml index 33f45ce8..2685dd86 100644 --- a/xml/cl.xml +++ b/xml/cl.xml @@ -1330,7 +1330,7 @@ server's OpenCL/api-docs repository. - + @@ -1780,7 +1780,8 @@ server's OpenCL/api-docs repository. - + + @@ -7186,7 +7187,7 @@ server's OpenCL/api-docs repository. - + @@ -7203,13 +7204,13 @@ server's OpenCL/api-docs repository. + -