IOCTL_PMI_GET_MEASUREMENT IOCTL (pmi.h)
Запрос IOCTL_PMI_GET_MEASUREMENT возвращает текущие данные измерений от счетчика мощности.
Основной код
Входной буфер
Выделенный инициатором выходной буфер, на который указывает элемент AssociatedIrp.SystemBuffer IRP.
Длина входного буфера
Элемент Parameters.DeviceIoControl.OutputBufferLength текущего расположения стека IRP (IO_STACK_LOCATION) имеет размер в байтах выделенного инициатором выходного буфера, на который указывает элемент AssociatedIrp.SystemBuffer IRP. Этот размер должен быть больше или равен sizeof(PMI_MEASUREMENT_DATA), иначе запрос завершается ошибкой с состоянием STATUS_BUFFER_TOO_SMALL.
Выходной буфер
Если запрос завершается успешно, выходной буфер, на который указывает элемент AssociatedIrp.SystemBuffer , содержит структуру PMI_MEASUREMENT_DATA . Эта структура содержит запрошенные данные измерений.
Длина выходного буфера
Размер структуры PMI_MEASUREMENT_DATA .
Блок состояния
Элемент Information имеет размер структуры PMI_MEASUREMENT_DATA в байтах.
Для элемента Status задано одно из следующих значений:
STATUS_BUFFER_TOO_SMALL
Элемент Parameters.DeviceIoControl.OutputBufferLengthIRP меньше размера в байтах структуры PMI_MEASUREMENT_DATA .
STATUS_SUCCESS
Драйвер WDM, поддерживающий интерфейс PMI, успешно завершил запрос IOCTL.
Комментарии
Запрос IOCTL_PMI_GET_MEASUREMENT запрашивает текущие данные измерений от счетчика мощности. Эти данные измерения выборки и усреднены на основе параметров конфигурации измерения счетчика электроэнергии. Параметры конфигурации измерения запрашиваются через запрос IOCTL_PMI_GET_CONFIGURATION с входным PMI_CONFIGURATION_TYPEзначением PmiMeasurementConfiguration.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 7, Windows Server 2008 R2 и более поздних версиях операционных систем Windows. |
| Верхняя часть | pmi.h (включая Pmi.h) |