IOCTL_ACPI_ASYNC_EVAL_METHOD IOCTL (acpiioct.h)
Драйвер для устройства может использовать запрос IOCTL_ACPI_ASYNC_EVAL_METHOD управления устройством для асинхронной оценки метода управления ACPI, поддерживаемого устройством. Драйвер должен вызвать IoBuildDeviceIoControlRequest и передать следующие входные и выходные параметры для сборки этого запроса.
Основной код
Входной буфер
Задайте входные параметры 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_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) |
См. также раздел
ACPI_EVAL_INPUT_BUFFER_COMPLEX
ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER