Command List - Experimental

oneAPI Level Zero Specification - Version 1.18.31

Command List - Experimental Functions

zetCommandListAppendMarkerExp

Added in version 1.13

ZE_APIEXPORT ze_result_t ZE_APICALL zetCommandListAppendMarkerExp(zet_command_list_handle_t hCommandList, zet_metric_group_handle_t hMetricGroup, uint32_t value)

Append a Marker based on the Metric source of the Metric Group, to a Command List.

• This function appends a Marker based on the Metric source of the Metric Group, to Command List.

Parameters:

• hCommandList – [in] handle to the command list

• hMetricGroup – [in] handle to the marker metric group. zet_metric_group_type_exp_flags_t could be used to check whether marker is supoported by the metric group.

• value – [in] marker value

Returns:

• ZE_RESULT_SUCCESS

• ZE_RESULT_ERROR_UNINITIALIZED

• ZE_RESULT_ERROR_DEVICE_LOST

• ZE_RESULT_ERROR_OUT_OF_HOST_MEMORY

• ZE_RESULT_ERROR_OUT_OF_DEVICE_MEMORY

• ZE_RESULT_ERROR_INVALID_ARGUMENT

• ZE_RESULT_ERROR_UNSUPPORTED_FEATURE

• ZE_RESULT_ERROR_DEPENDENCY_UNAVAILABLE

• ZE_RESULT_ERROR_INSUFFICIENT_PERMISSIONS

• ZE_RESULT_ERROR_NOT_AVAILABLE

• ZE_RESULT_ERROR_DEVICE_REQUIRES_RESET

• ZE_RESULT_ERROR_DEVICE_IN_LOW_POWER_STATE

• ZE_RESULT_ERROR_UNKNOWN

• ZE_RESULT_ERROR_INVALID_NULL_HANDLE

  • nullptr == hCommandList

  • nullptr == hMetricGroup