IOCTL_ACPI_ASYNC_EVAL_METHOD IOCTL (acpiioct.h)

Статья
08/07/2023

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

Основной код

IRP_MJ_DEVICE_CONTROL

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

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

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

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

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_ASYNC_EVAL_METHOD для асинхронной оценки метода управления, который поддерживает устройство. Например, если устройство имеет имя "ABCD" в пространстве имен ACPI, а устройство "ABCD" поддерживает метод с именем "_FOO", этот IOCTL можно использовать для оценки метода управления "_FOO", отправив запрос на устройство "ABCD" и указав имя метода управления "_FOO".

IOCTL_ACPI_ASYNC_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 см. в разделах IOCTL_ACPI_EVAL_METHOD, IOCTL_ACPI_EVAL_METHOD_EX и Синхронная оценка методов управления ACPI.

IOCTL_ACPI_ASYNC_EVAL_METHOD можно использовать только в irQL <= DISPATCH_LEVEL.

Требования

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