Add command-buffer context query

Introduce query `CL_COMMAND_BUFFER_CONTEXT_KHR` for the `cl_context` associated with a command-buffer. This PR uses enum value `0x1299` which is also attempting be used by another command-buffer PR KhronosGroup#850 However, that PR still needs review so would prefer to use that enum here as `0x1299` is contiguous with the other command-buffer query enums, and I can find a new value for PR KhronosGroup#850 Closes KhronosGroup#898
EwanC · Mar 31, 2023 · e1bc510 · e1bc510
1 parent 585786a
commit e1bc510
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 2 deletions.
diff --git a/ext/cl_khr_command_buffer.asciidoc b/ext/cl_khr_command_buffer.asciidoc
@@ -20,6 +20,7 @@ This extension adds the ability to record and replay buffers of OpenCL commands.
 | *Date*     | *Version* | *Description*
 | 2021-11-10 | 0.9.0     | First assigned version (provisional).
 | 2022-08-24 | 0.9.1     | Specify an error if a command-buffer is finalized multiple times (provisional).
+| 2023-03-31 | 0.9.2     | Introduce context query {CL_COMMAND_BUFFER_CONTEXT_KHR} (provisional).
 |====
 
 ==== Dependencies
@@ -422,6 +423,7 @@ CL_COMMAND_BUFFER_NUM_QUEUES_KHR                   0x1295
 CL_COMMAND_BUFFER_REFERENCE_COUNT_KHR              0x1296
 CL_COMMAND_BUFFER_STATE_KHR                        0x1297
 CL_COMMAND_BUFFER_PROPERTIES_ARRAY_KHR             0x1298
+CL_COMMAND_BUFFER_CONTEXT_KHR                      0x1299
 
 // cl_event command-buffer enqueue command type
 CL_COMMAND_COMMAND_BUFFER_KHR                      0x12A8
@@ -1590,6 +1592,10 @@ _param_value_ by {clGetCommandBufferInfoKHR} is described in the table below.
   or the implementation may return a property value of 0 (where 0 is used to
   terminate the properties list).
 
+| {CL_COMMAND_BUFFER_CONTEXT_KHR}
+| {cl_context_TYPE}
+| Return the context associated with _command_buffer_.
+
 |====
 
 {clGetCommandBufferInfoKHR} returns {CL_SUCCESS} if the function is executed

diff --git a/xml/cl.xml b/xml/cl.xml
@@ -1728,7 +1728,7 @@ server's OpenCL/api-docs repository.
         <enum value="0x1296"             name="CL_COMMAND_BUFFER_REFERENCE_COUNT_KHR"/>
         <enum value="0x1297"             name="CL_COMMAND_BUFFER_STATE_KHR"/>
         <enum value="0x1298"             name="CL_COMMAND_BUFFER_PROPERTIES_ARRAY_KHR"/>
-            <unused start="0x1299" comment="Reserved for MR199"/>
+        <enum value="0x1299"             name="CL_COMMAND_BUFFER_CONTEXT_KHR"/>
             <unused start="0x129A" end="0x129F" comment="Available to use"/>
         <enum value="0x12A0"             name="CL_MUTABLE_COMMAND_COMMAND_QUEUE_KHR"/>
         <enum value="0x12A1"             name="CL_MUTABLE_COMMAND_COMMAND_BUFFER_KHR"/>
@@ -7038,7 +7038,7 @@ server's OpenCL/api-docs repository.
                 <command name="clSetContentSizeBufferPoCL"/>
             </require>
         </extension>
-        <extension name="cl_khr_command_buffer" comment="in sync with version 0.9.0" supported="opencl">
+        <extension name="cl_khr_command_buffer" comment="in sync with version 0.9.2" supported="opencl">
             <require>
                 <type name="CL/cl.h"/>
             </require>
@@ -7080,6 +7080,7 @@ server's OpenCL/api-docs repository.
                <enum name="CL_COMMAND_BUFFER_REFERENCE_COUNT_KHR"/>
                <enum name="CL_COMMAND_BUFFER_STATE_KHR"/>
                <enum name="CL_COMMAND_BUFFER_PROPERTIES_ARRAY_KHR"/>
+               <enum name="CL_COMMAND_BUFFER_CONTEXT_KHR"/>
             </require>
             <require comment="cl_command_buffer_state_khr">
                <enum name="CL_COMMAND_BUFFER_STATE_RECORDING_KHR"/>