emi.h header

Article
01/24/2023

This header is used by Power Metering and Budgeting Reference. For more information, see:

Power Metering and Budgeting Reference

emi.h contains the following programming interfaces:

IOCTLs


IOCTL_EMI_GET_MEASUREMENT The IOCTL_EMI_GET_MEASUREMENT control code retrieves the current energy measurement and the time at which the measurement was taken.
IOCTL_EMI_GET_METADATA The IOCTL_EMI_GET_METADATA control code retrieves EMI metadata from a device.
IOCTL_EMI_GET_METADATA_SIZE The IOCTL_EMI_GET_METADATA_SIZE control code retrieves the size of the EMI metadata object that can be obtained from the device by issuing an IOCTL_EMI_GET_METADATA request.
IOCTL_EMI_GET_VERSION The IOCTL_EMI_GET_VERSION control code retrieves the current version of the EMI interface supported by the device.

Structures


EMI_CHANNEL_MEASUREMENT_DATA The EMI_MEASUREMENT_DATA structure provides data about the current energy measurement and the time at which the measurement was taken.
EMI_CHANNEL_V2 The EMI_CHANNEL_V2 structure provides data about an EMI V2 channel.
EMI_MEASUREMENT_DATA_V2 The EMI_MEASUREMENT_DATA_V2 structure provides data about the current energy measurement data for all channels of an EMI_VERSION_V2 device.
EMI_METADATA_SIZE The EMI_METADATA_SIZE structure specifies the size of the Energy Metering Interface (EMI) metadata object that can be obtained from the device by issuing an IOCTL_EMI_GET_METADATA request.
EMI_METADATA_V1 The EMI_METADATA structure provides metadata about a device that supports the Energy Metering Interface (EMI) interface, such as the hardware model and hardware revision.
EMI_METADATA_V2 The EMI_METADATA_V2 structure provides metadata about a device that supports the EMI_VERSION_V2 interface. This metadata contains information about the hardware device and what EMI channels are exposed by this device.
EMI_VERSION The EMI_VERSION structure describes the version of the Energy Metering Interface (EMI) that is supported by a device.

Enumerations


EMI_MEASUREMENT_UNIT The EMI_MEASUREMENT_UNIT enumeration represents the available units of energy measurements that can be retrieved from a device by using IOCTL_EMI_GET_MEASUREMENT.