Merge pull request #1975 from Bensuo/fabio/immediate_append_exp

[Command-Buffers] Implement new command-list enqueue path
oneapi-src · Nov 21, 2024 · 20e501a · 20e501a
2 parents dcf35a1 + ca878c5
commit 20e501a
Show file tree

Hide file tree

Showing 5 changed files with 526 additions and 142 deletions.
diff --git a/scripts/core/LEVEL_ZERO.rst b/scripts/core/LEVEL_ZERO.rst
@@ -139,8 +139,15 @@ Environment Variables
 | UR_L0_DISABLE_USM_ALLOCATOR                 | Controls the use of the USM allocator.                       | "0": USM allocator is enabled.                               | "0"              |
 |                                             |                                                              | Any other value: USM allocator is disabled.                  |                  |
 +---------------------------------------------+--------------------------------------------------------------+--------------------------------------------------------------+------------------+
-
+| UR_L0_CMD_BUFFER_USE_IMMEDIATE_APPEND_PATH  | Controls which command-buffer implementation path is used.   | "1": the immediate append path will always be enabled as     | Unset            |
+|                                             | The paths rely on different APIs to enqueue command-buffers. | long as the pre-requisites are met.                          |                  |
+|                                             | The immediate append path relies on                          | "0": the immediate append path will always be disabled.      |                  |
+|                                             | zeCommandListImmediateAppendCommandListsExp().               | "unset": The default behaviour will be used which enables    |                  |
+|                                             | The wait-event path relies on                                | the immediate append path only for some devices when the     |                  |
+|                                             | zeCommandQueueExecuteCommandLists()                          | pre-requisites are met.                                      |                  |
++---------------------------------------------+--------------------------------------------------------------+--------------------------------------------------------------+------------------+
 Contributors
 ------------
 
-* Neil Spruit `[email protected] <[email protected]>`_
+* Neil Spruit `[email protected] <[email protected]>`_
+* Fábio Mestre `[email protected] <[email protected]>`_