IOCTL_ACPI_EVAL_METHOD IOCTL (acpiioct.h)

Статья
02/26/2024

Драйвер для устройства может использовать IOCTL_ACPI_EVAL_METHOD запрос на управление устройством для синхронной оценки метода управления ACPI, поддерживаемого устройством. Драйвер должен вызвать IoBuildDeviceIoControlRequest и передать следующие входные и выходные параметры для построения этого запроса.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Задайте входные параметры IoBuildDeviceIoControlRequest следующим образом:

IoControlCode имеет значение IOCTL_ACPI_EVAL_METHOD.
DeviceObject — это указатель на физический объект устройства (PDO).
InputBuffer имеет указатель на структуру входного буфера, которая зависит от типа входных аргументов, передаваемых методу элемента управления. Дополнительные сведения о типе входных аргументов, поддерживаемых этим IOCTL, см. в разделе Примечания далее в этом разделе.
InputBufferLength устанавливается в размере входного буфера в байтах, предоставляемого InputBuffer.
OutputBufferLength предоставляет размер выходного буфера в байтах, предоставляемый OutputBuffer.
Параметр InternalDeviceIoControl имеет значение FALSE.
Событие — это указатель на выделенный вызывающим и инициализированный объект события.

Длина входного буфера

InputBufferLength устанавливается в размере входного буфера в байтах, предоставляемого InputBuffer.

Выходной буфер

Задайте выходные параметры IoBuildDeviceIoControlRequest следующим образом:

OutputBuffer предоставляет указатель на структуру ACPI_EVAL_OUTPUT_BUFFER , содержащую выходные аргументы из метода элемента управления.
IoStatusBlock имеет IO_STATUS_BLOCK структуру.

Длина выходного буфера

OutputBufferLength предоставляет размер выходного буфера в байтах, предоставляемый OutputBuffer.

Блок состояния

Если запрос выполнен успешно, ioStatusBlock-Status> получает значение STATUS_SUCCESS; в противном случае члену Status присваивается код ошибки. Если выходной буфер недостаточно велик, чтобы содержать заголовок выходного буфера, для элемента Status устанавливается значение STATUS_BUFFER_TOO_SMALL. Если выходной буфер достаточно велик, чтобы содержать заголовок выходного буфера, но не достаточно велик, чтобы содержать все выходные аргументы из метода управления, для элемента Status устанавливается значение STATUS_BUFFER_OVERFLOW, а для OutputBuffer-Length> устанавливается необходимая длина выходного буфера.

Если запрос выполнен успешно, для элемента IoStatusBlock-Information> устанавливается количество байтов, возвращаемых в выходном буфере; в противном случае элементу Information присваивается значение 0.

Драйвер для устройства может использовать IOCTL_ACPI_EVAL_METHOD для синхронной оценки метода управления, который поддерживает устройство. Например, если устройство называется "ABCD" в пространстве имен ACPI, а устройство "ABCD" поддерживает метод с именем "_FOO", этот IOCTL можно использовать для оценки метода управления "_FOO", отправляя запрос на устройство "ABCD" и предоставляя имя метода управления "_FOO".

IOCTL_ACPI_EVAL_METHOD поддерживает следующие типы структур входных буферов:

ACPI_EVAL_INPUT_BUFFER

ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER

ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING

ACPI_EVAL_INPUT_BUFFER_COMPLEX

Выходные аргументы из метода управления возвращаются в структуре ACPI_EVAL_OUTPUT_BUFFER переменной длины, предоставляемой указателем OutBuffer . ACPI_EVAL_OUTPUT_BUFFER включает массив структур ACPI_METHOD_ARGUMENT переменной длины, каждая из которых возвращает выходной аргумент.

Дополнительные сведения о синхронной оценке методов управления см. в статье Синхронная оценка методов управления ACPI.

Начиная с Windows Server 2008 и Windows Vista драйвер также может использовать IOCTL_ACPI_EVAL_METHOD_EX запрос для синхронной оценки метода управления, который не является непосредственным дочерним объектом устройства.

Сведения о том, как асинхронно оценить метод управления ACPI, начиная с Windows Server 2008 и Windows Vista, см. в разделе IOCTL_ACPI_ASYNC_EVAL_METHOD и IOCTL_ACPI_ASYNC_EVAL_METHOD_EX.

IOCTL_ACPI_EVAL_METHOD можно использовать только на DISPATCH_LEVEL IRQL < .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 и более поздние версии Windows.
Верхняя часть	acpiioct.h (включая Acpiioct.h)