Psu#
oneAPI Level Zero Specification - Version 1.18.31
Psu Functions#
zesPsuGetProperties#
Added in version 1.0
-
ZE_APIEXPORT ze_result_t ZE_APICALL zesPsuGetProperties(zes_psu_handle_t hPsu, zes_psu_properties_t *pProperties)#
Get power supply properties.
The application may call this function from simultaneous threads.
The implementation of this function should be lock-free.
- Parameters:
hPsu – [in] Handle for the component.
pProperties – [in,out] Will contain the properties of the power supply.
- Returns:
ZE_RESULT_ERROR_INVALID_NULL_HANDLE
nullptr == hPsu
ZE_RESULT_ERROR_INVALID_NULL_POINTER
nullptr == pProperties
zesPsuGetState#
Added in version 1.0
-
ZE_APIEXPORT ze_result_t ZE_APICALL zesPsuGetState(zes_psu_handle_t hPsu, zes_psu_state_t *pState)#
Get current power supply state.
The application may call this function from simultaneous threads.
The implementation of this function should be lock-free.
- Parameters:
hPsu – [in] Handle for the component.
pState – [in,out] Will contain the current state of the power supply.
- Returns:
ZE_RESULT_ERROR_INVALID_NULL_HANDLE
nullptr == hPsu
ZE_RESULT_ERROR_INVALID_NULL_POINTER
nullptr == pState
Psu Enums#
zes_psu_voltage_status_t#
Added in version 1.0
-
enum zes_psu_voltage_status_t#
PSU voltage status.
Values:
-
enumerator ZES_PSU_VOLTAGE_STATUS_UNKNOWN#
The status of the power supply voltage controllers cannot be determined
-
enumerator ZES_PSU_VOLTAGE_STATUS_NORMAL#
No unusual voltages have been detected.
-
enumerator ZES_PSU_VOLTAGE_STATUS_OVER#
Over-voltage has occurred.
-
enumerator ZES_PSU_VOLTAGE_STATUS_UNDER#
Under-voltage has occurred.
-
enumerator ZES_PSU_VOLTAGE_STATUS_FORCE_UINT32#
Value marking end of ZES_PSU_VOLTAGE_STATUS_* ENUMs.
-
enumerator ZES_PSU_VOLTAGE_STATUS_UNKNOWN#
Psu Structures#
zes_psu_properties_t#
Added in version 1.0
-
struct zes_psu_properties_t#
Static properties of the power supply.
Public Members
-
zes_structure_type_t stype#
[in] type of this structure
-
void *pNext#
[in,out][optional] must be null or a pointer to an extension-specific structure (i.e. contains stype and pNext).
-
ze_bool_t onSubdevice#
[out] True if the resource is located on a sub-device; false means that the resource is on the device of the calling Sysman handle
-
uint32_t subdeviceId#
[out] If onSubdevice is true, this gives the ID of the sub-device
-
ze_bool_t haveFan#
[out] True if the power supply has a fan
-
int32_t ampLimit#
[out] The maximum electrical current in milliamperes that can be drawn. A value of -1 indicates that this property cannot be determined.
-
zes_structure_type_t stype#
zes_psu_state_t#
Added in version 1.0
-
struct zes_psu_state_t#
Dynamic state of the power supply.
Public Members
-
zes_structure_type_t stype#
[in] type of this structure
-
const void *pNext#
[in][optional] must be null or a pointer to an extension-specific structure (i.e. contains stype and pNext).
-
zes_psu_voltage_status_t voltStatus#
[out] The current PSU voltage status
-
ze_bool_t fanFailed#
[out] Indicates if the fan has failed
-
int32_t temperature#
[out] Read the current heatsink temperature in degrees Celsius. A value of -1 indicates that this property cannot be determined.
-
int32_t current#
[out] The amps being drawn in milliamperes. A value of -1 indicates that this property cannot be determined.
-
zes_structure_type_t stype#