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

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

package gozel

import (
	"unsafe"

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

// ZeDefaultGPUImmediateCommandQueueDesc Immediate Command List default descriptor for GPU devices
var ZeDefaultGPUImmediateCommandQueueDesc = ZeCommandQueueDesc{
	ZE_STRUCTURE_TYPE_COMMAND_QUEUE_DESC, ///< stype
	nil,                                  ///< pNext
	0,                                    ///< ordinal
	0,                                    ///< index
	ZE_COMMAND_QUEUE_FLAG_IN_ORDER | ZE_COMMAND_QUEUE_FLAG_COPY_OFFLOAD_HINT, ///< flags
	ZE_COMMAND_QUEUE_MODE_ASYNCHRONOUS,                                       ///< mode
	ZE_COMMAND_QUEUE_PRIORITY_NORMAL,                                         ///< priority
}

// ZeDefaultGPUDeviceMemAllocDesc Device Unified Shared Memory Allocation default descriptor for GPU
// /        devices
var ZeDefaultGPUDeviceMemAllocDesc = ZeDeviceMemAllocDesc{
	ZE_STRUCTURE_TYPE_DEVICE_MEM_ALLOC_DESC, ///< stype
	nil,                                     ///< pNext
	ZE_DEVICE_MEM_ALLOC_FLAG_BIAS_CACHED,    ///< flags
	0,                                       ///< ordinal
}

// ZeDefaultGPUHostMemAllocDesc Host Unified Shared Memory Allocation default descriptor for GPU
// /        devices
var ZeDefaultGPUHostMemAllocDesc = ZeHostMemAllocDesc{
	ZE_STRUCTURE_TYPE_HOST_MEM_ALLOC_DESC, ///< stype
	nil,                                   ///< pNext
	ZE_HOST_MEM_ALLOC_FLAG_BIAS_CACHED | ZE_HOST_MEM_ALLOC_FLAG_BIAS_INITIAL_PLACEMENT, ///< flags
}

// ZerGetLastErrorDescription Retrieves a string describing the last error code returned by the
// /        default driver in the current thread.
// /
// / @details
// /     - String returned is thread local.
// /     - String is only updated on calls returning an error, i.e., not on calls
// /       returning ::ZE_RESULT_SUCCESS.
// /     - String may be empty if driver considers error code is already explicit
// /       enough to describe cause.
// /     - Memory pointed to by ppString is owned by the default driver.
// /     - String returned is null-terminated.
// /
// / @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_POINTER
// /         + `nullptr == ppString`
func ZerGetLastErrorDescription(
	ppString **byte, // ppString [in,out] pointer to a null-terminated array of characters describing cause of error.
) (ZeResult, error) {
	return zecall.Call[ZeResult]("zerGetLastErrorDescription", uintptr(unsafe.Pointer(ppString)))
}

// ZerTranslateDeviceHandleToIdentifier Translates device handle to integer identifier.
// /
// / @details
// /     - The implementation of this function should be lock-free.
// /     - This function does not return error code, to get info about failure
// /       user may use ::zerGetLastErrorDescription function.
// /     - In case of failure, this function returns UINT32_MAX.
// /
// / @returns
// /     - integer identifier for the device
// /     - UINT32_MAX
func ZerTranslateDeviceHandleToIdentifier(
	hDevice ZeDeviceHandle, // hDevice [in] handle of the device
) (uint32, error) {
	return zecall.Call[uint32]("zerTranslateDeviceHandleToIdentifier", uintptr(hDevice))
}

// ZerTranslateIdentifierToDeviceHandle Translates to integer identifier to a device handle.
// /
// / @details
// /     - The driver must be initialized before calling this function.
// /     - The implementation of this function should be lock-free.
// /     - This function does not return error code, to get info about failure
// /       user may use ::zerGetLastErrorDescription function.
// /     - In case of failure, this function returns null.
// /     - Details on the error can be retrieved using
// /       ::zerGetLastErrorDescription function.
// /
// / @returns
// /     - handle of the device with the given identifier
// /     - nullptr
func ZerTranslateIdentifierToDeviceHandle(
	identifier uint32, // identifier [in] integer identifier of the device
) (ZeDeviceHandle, error) {
	return zecall.Call[ZeDeviceHandle]("zerTranslateIdentifierToDeviceHandle", uintptr(identifier))
}

// ZerGetDefaultContext Retrieves handle to default context from the default driver.
// /
// / @details
// /     - The driver must be initialized before calling this function.
// /     - The implementation of this function should be lock-free.
// /     - This returned context contains all the devices available in the
// /       default driver.
// /     - This function does not return error code, to get info about failure
// /       user may use ::zerGetLastErrorDescription function.
// /     - In case of failure, this function returns null.
// /     - Details on the error can be retrieved using
// /       ::zerGetLastErrorDescription function.
// /
// / @returns
// /     - handle of the default context
// /     - nullptr
func ZerGetDefaultContext() (ZeContextHandle, error) {
	return zecall.Call[ZeContextHandle]("zerGetDefaultContext")
}