// Code generated by cmd/gen. DO NOT EDIT.

/*
 *
 * Copyright (C) 2019-2025 Intel Corporation
 *
 * SPDX-License-Identifier: MIT
 *
 * @file zet_api.h
 * @version v1.15-r1.15.31
 *
 */

package gozel

import (
	"unsafe"

	"github.com/fumiama/gozel/internal/zecall"
)

// ZET_METRIC_GROUP_MARKER_EXP_NAME Marker Support Using MetricGroup Experimental Extension Name
const ZET_METRIC_GROUP_MARKER_EXP_NAME = "ZET_experimental_metric_group_marker"

// ZetMetricGroupMarkerExpVersion (zet_metric_group_marker_exp_version_t) Marker Support Using MetricGroup Experimental Extension Version(s)
type ZetMetricGroupMarkerExpVersion uintptr
const (
	ZET_METRIC_GROUP_MARKER_EXP_VERSION_1_0 ZetMetricGroupMarkerExpVersion = /* ZE_MAKE_VERSION( 1, 0 ) */((( 1 << 16 )|( 0 & 0x0000ffff)))	// ZET_METRIC_GROUP_MARKER_EXP_VERSION_1_0 version 1.0
	ZET_METRIC_GROUP_MARKER_EXP_VERSION_CURRENT ZetMetricGroupMarkerExpVersion = /* ZE_MAKE_VERSION( 1, 0 ) */((( 1 << 16 )|( 0 & 0x0000ffff)))	// ZET_METRIC_GROUP_MARKER_EXP_VERSION_CURRENT latest known version
	ZET_METRIC_GROUP_MARKER_EXP_VERSION_FORCE_UINT32 ZetMetricGroupMarkerExpVersion = 0x7fffffff	// ZET_METRIC_GROUP_MARKER_EXP_VERSION_FORCE_UINT32 Value marking end of ZET_METRIC_GROUP_MARKER_EXP_VERSION_* ENUMs

)

// ZetMetricSourceIdExp (zet_metric_source_id_exp_t) Query the metric source unique identifier using `pNext` of
///        ::zet_metric_group_properties_t
type ZetMetricSourceIdExp struct {
	Stype ZetStructureType	// Stype [in] type of this structure
	Pnext unsafe.Pointer	// Pnext [in,out][optional] must be null or a pointer to an extension-specific structure (i.e. contains stype and pNext).
	Sourceid uint32	// Sourceid [out] unique number representing the Metric Source.

}

// ZetCommandListAppendMarkerExp Append a Marker based on the Metric source of the Metric Group, to a
///        Command List.
/// 
/// @details
///     - This function appends a Marker based on the Metric source of the
///       Metric Group, to Command List.
/// 
/// @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`
func ZetCommandListAppendMarkerExp(
	hCommandList ZetCommandListHandle,	// hCommandList [in] handle to the command list
	hMetricGroup ZetMetricGroupHandle,	// 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 uint32,	// value [in] marker value
) (ZeResult, error) {
	return zecall.Call[ZeResult]("zetCommandListAppendMarkerExp", uintptr(hCommandList), uintptr(hMetricGroup), uintptr(value))
}