|
5 | 5 | * SPDX-License-Identifier: MIT |
6 | 6 | * |
7 | 7 | * @file ze_api.h |
8 | | - * @version v1.15-r1.15.26 |
| 8 | + * @version v1.15-r1.15.31 |
9 | 9 | * |
10 | 10 | */ |
11 | 11 | #ifndef _ZE_API_H |
@@ -3042,10 +3042,11 @@ typedef enum _ze_command_queue_flag_t |
3042 | 3042 | ///< the next to define an in-order list, and application is allowed to |
3043 | 3043 | ///< pass signal and wait events |
3044 | 3044 | ///< to each appended command to implement more complex dependency graphs. |
3045 | | - ZE_COMMAND_QUEUE_FLAG_COPY_OFFLOAD_HINT = ZE_BIT(2), ///< Try to offload copy operations to different engines. Applicable only |
3046 | | - ///< for compute queues. |
3047 | | - ///< This is only a hint. Driver may ignore it per append call, based on |
3048 | | - ///< platform capabilities or internal heuristics. |
| 3045 | + ZE_COMMAND_QUEUE_FLAG_COPY_OFFLOAD_HINT = ZE_BIT(2), ///< To be used only when creating immediate command lists and only for |
| 3046 | + ///< compute queues. |
| 3047 | + ///< Try to offload copy operations to different engines. This is only a hint. |
| 3048 | + ///< Driver may ignore it per append call, based on platform capabilities |
| 3049 | + ///< or internal heuristics. |
3049 | 3050 | ZE_COMMAND_QUEUE_FLAG_FORCE_UINT32 = 0x7fffffff ///< Value marking end of ZE_COMMAND_QUEUE_FLAG_* ENUMs |
3050 | 3051 |
|
3051 | 3052 | } ze_command_queue_flag_t; |
@@ -3376,6 +3377,10 @@ typedef enum _ze_command_list_flag_t |
3376 | 3377 | ///< more complex dependency graphs. Cannot be combined with ::ZE_COMMAND_LIST_FLAG_RELAXED_ORDERING. |
3377 | 3378 | ZE_COMMAND_LIST_FLAG_EXP_CLONEABLE = ZE_BIT(4), ///< this command list may be cloned using ::zeCommandListCreateCloneExp |
3378 | 3379 | ///< after ::zeCommandListClose. |
| 3380 | + ZE_COMMAND_LIST_FLAG_COPY_OFFLOAD_HINT = ZE_BIT(5), ///< Try to offload copy operations to different engines. Applicable only |
| 3381 | + ///< for compute queues. |
| 3382 | + ///< This is only a hint. Driver may ignore it per append call, based on |
| 3383 | + ///< platform capabilities or internal heuristics. |
3379 | 3384 | ZE_COMMAND_LIST_FLAG_FORCE_UINT32 = 0x7fffffff ///< Value marking end of ZE_COMMAND_LIST_FLAG_* ENUMs |
3380 | 3385 |
|
3381 | 3386 | } ze_command_list_flag_t; |
@@ -3429,7 +3434,7 @@ typedef struct _ze_command_list_desc_t |
3429 | 3434 | /// + `nullptr == desc` |
3430 | 3435 | /// + `nullptr == phCommandList` |
3431 | 3436 | /// - ::ZE_RESULT_ERROR_INVALID_ENUMERATION |
3432 | | -/// + `0x1f < desc->flags` |
| 3437 | +/// + `0x3f < desc->flags` |
3433 | 3438 | /// - ::ZE_RESULT_ERROR_UNSUPPORTED_ENUMERATION |
3434 | 3439 | ZE_APIEXPORT ze_result_t ZE_APICALL |
3435 | 3440 | zeCommandListCreate( |
@@ -4103,6 +4108,7 @@ zeCommandListAppendMemoryCopy( |
4103 | 4108 | /// + `nullptr == ptr` |
4104 | 4109 | /// + `nullptr == pattern` |
4105 | 4110 | /// - ::ZE_RESULT_ERROR_INVALID_SYNCHRONIZATION_OBJECT |
| 4111 | +/// - ::ZE_RESULT_ERROR_UNSUPPORTED_ALIGNMENT |
4106 | 4112 | /// - ::ZE_RESULT_ERROR_INVALID_SIZE |
4107 | 4113 | /// + `(nullptr == phWaitEvents) && (0 < numWaitEvents)` |
4108 | 4114 | ZE_APIEXPORT ze_result_t ZE_APICALL |
@@ -8632,21 +8638,21 @@ typedef enum _ze_module_program_exp_version_t |
8632 | 8638 | /// - Implementation must support ::ZE_MODULE_PROGRAM_EXP_NAME extension |
8633 | 8639 | /// - Modules support import and export linkage for functions and global |
8634 | 8640 | /// variables. |
8635 | | -/// - SPIR-V import and export linkage types are used. See SPIR-V |
8636 | | -/// specification for linkage details. |
8637 | 8641 | /// - pInputModules, pBuildFlags, and pConstants from ::ze_module_desc_t is |
8638 | 8642 | /// ignored. |
8639 | 8643 | /// - Format in ::ze_module_desc_t needs to be set to |
8640 | | -/// ::ZE_MODULE_FORMAT_IL_SPIRV. |
| 8644 | +/// ::ZE_MODULE_FORMAT_IL_SPIRV or ::ZE_MODULE_FORMAT_NATIVE. |
| 8645 | +/// - All modules in the list must be of the same format and match the |
| 8646 | +/// format specified in ::ze_module_desc_t. |
8641 | 8647 | typedef struct _ze_module_program_exp_desc_t |
8642 | 8648 | { |
8643 | 8649 | ze_structure_type_t stype; ///< [in] type of this structure |
8644 | 8650 | const void* pNext; ///< [in][optional] must be null or a pointer to an extension-specific |
8645 | 8651 | ///< structure (i.e. contains stype and pNext). |
8646 | 8652 | uint32_t count; ///< [in] Count of input modules |
8647 | | - const size_t* inputSizes; ///< [in][range(0, count)] sizes of each input IL module in pInputModules. |
8648 | | - const uint8_t** pInputModules; ///< [in][range(0, count)] pointer to an array of IL (e.g. SPIR-V modules). |
8649 | | - ///< Valid only for SPIR-V input. |
| 8653 | + const size_t* inputSizes; ///< [in][range(0, count)] sizes of each input module in pInputModules. |
| 8654 | + const uint8_t** pInputModules; ///< [in][range(0, count)] pointer to an array of binary modules in format |
| 8655 | + ///< specified as part of ::ze_module_desc_t. |
8650 | 8656 | const char** pBuildFlags; ///< [in][optional][range(0, count)] array of strings containing build |
8651 | 8657 | ///< flags. See pBuildFlags in ::ze_module_desc_t. |
8652 | 8658 | const ze_module_constants_t** pConstants; ///< [in][optional][range(0, count)] pointer to array of specialization |
@@ -9976,9 +9982,10 @@ ZE_APIEXPORT ze_result_t ZE_APICALL |
9976 | 9982 | zeCommandListAppendSignalExternalSemaphoreExt( |
9977 | 9983 | ze_command_list_handle_t hCommandList, ///< [in] The command list handle. |
9978 | 9984 | uint32_t numSemaphores, ///< [in] The number of external semaphores. |
9979 | | - ze_external_semaphore_ext_handle_t* phSemaphores, ///< [in][range(0, numSemaphores)] The vector of external semaphore handles |
9980 | | - ///< to be appended into command list. |
9981 | | - ze_external_semaphore_signal_params_ext_t* signalParams, ///< [in] Signal parameters. |
| 9985 | + ze_external_semaphore_ext_handle_t* phSemaphores, ///< [in][range(0, numSemaphores)] The array of pointers to external |
| 9986 | + ///< semaphore handles to be appended into command list. |
| 9987 | + ze_external_semaphore_signal_params_ext_t* signalParams, ///< [in][range(0, numSemaphores)] The array of pointers to external |
| 9988 | + ///< semaphore signal parameters. |
9982 | 9989 | ze_event_handle_t hSignalEvent, ///< [in][optional] handle of the event to signal on completion |
9983 | 9990 | uint32_t numWaitEvents, ///< [in][optional] number of events to wait on before launching; must be 0 |
9984 | 9991 | ///< if `nullptr == phWaitEvents` |
@@ -10025,9 +10032,10 @@ ZE_APIEXPORT ze_result_t ZE_APICALL |
10025 | 10032 | zeCommandListAppendWaitExternalSemaphoreExt( |
10026 | 10033 | ze_command_list_handle_t hCommandList, ///< [in] The command list handle. |
10027 | 10034 | uint32_t numSemaphores, ///< [in] The number of external semaphores. |
10028 | | - ze_external_semaphore_ext_handle_t* phSemaphores, ///< [in] [range(0,numSemaphores)] The vector of external semaphore handles |
10029 | | - ///< to append into command list. |
10030 | | - ze_external_semaphore_wait_params_ext_t* waitParams, ///< [in] Wait parameters. |
| 10035 | + ze_external_semaphore_ext_handle_t* phSemaphores, ///< [in][range(0,numSemaphores)] The array of pointers to external |
| 10036 | + ///< semaphore handles to append into command list. |
| 10037 | + ze_external_semaphore_wait_params_ext_t* waitParams, ///< [in][range(0,numSemaphores)] The array of pointers to external |
| 10038 | + ///< semaphore wait parameters. |
10031 | 10039 | ze_event_handle_t hSignalEvent, ///< [in][optional] handle of the event to signal on completion |
10032 | 10040 | uint32_t numWaitEvents, ///< [in][optional] number of events to wait on before launching; must be 0 |
10033 | 10041 | ///< if `nullptr == phWaitEvents` |
|
0 commit comments