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