Metric - Deprecated#
oneAPI Level Zero Specification - Version 1.20.41
Metric - Deprecated Functions#
zetMetricCreateFromProgrammableExp#
Added in version 1.9
Deprecated since 1.11. Use zetMetricCreateFromProgrammableExp2 instead.
-
ZE_APIEXPORT ze_result_t ZE_APICALL zetMetricCreateFromProgrammableExp(zet_metric_programmable_exp_handle_t hMetricProgrammable, zet_metric_programmable_param_value_exp_t *pParameterValues, uint32_t parameterCount, const char *pName, const char *pDescription, uint32_t *pMetricHandleCount, zet_metric_handle_t *phMetricHandles)#
Create metric handles by applying parameter values on the metric programmable handle.
- Parameters:
hMetricProgrammable – [in] handle of the metric programmable
pParameterValues – [in] list of parameter values to be set.
parameterCount – [in] Count of parameters to set.
pName – [in] pointer to metric name to be used. Must point to a null-terminated character array no longer than ZET_MAX_METRIC_NAME.
pDescription – [in] pointer to metric description to be used. Must point to a null-terminated character array no longer than ZET_MAX_METRIC_DESCRIPTION.
pMetricHandleCount – [in,out] Pointer to the number of metric handles. if count is zero, then the driver shall update the value with the number of metric handles available for this programmable. if count is greater than the number of metric handles available, then the driver shall update the value with the correct number of metric handles available.
phMetricHandles – [in,out][optional][range(0,*pMetricHandleCount)] array of handle of metrics. if count is less than the number of metrics available, then driver shall only retrieve that number of metric handles.
- Returns:
ZE_RESULT_ERROR_INVALID_NULL_HANDLE
nullptr == hMetricProgrammable
ZE_RESULT_ERROR_INVALID_NULL_POINTER
nullptr == pParameterValuesnullptr == pNamenullptr == pDescriptionnullptr == pMetricHandleCount