структура ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX (acpiioct.h)

Статья
02/06/2025

Структура ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX используется в качестве входных данных для запроса IOCTL_ACPI_EVAL_METHOD_EX и запроса IOCTL_ACPI_ASYNC_EVAL_METHOD_EX. Структура предоставляет путь и имя метода управления в пространстве имен ACPI и массив входных аргументов ACPI_METHOD_ARGUMENT структур.

Синтаксис

typedef struct _ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX {
  ULONG                   Signature;
  CHAR                    MethodName[256];
  ULONG                   Size;
  ULONG                   ArgumentCount;
  ACPI_METHOD_ARGUMENT_V1 Argument[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_EX;

Члены

Signature

Сигнатура расширенного сложного входного буфера, который должен иметь значение ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX.

MethodName[256]

Строка ASCII, завершающая значение NULL, содержащая путь и имя метода управления в пространстве имен ACPI. Максимальное число символов, которые может содержать строка, включая терминатор NULL, составляет 256.

Дополнительные сведения о том, как указать путь и имя метода управления, см. в разделе "Примечания" далее в этом разделе.

Size

Количество байтов, содержащих массив аргумента.

ArgumentCount

Количество структур ACPI_METHOD_ARGUMENT переменной длины, содержащих массив аргумента. Массив аргумента может содержать не более семи структур аргументов.

Argument[ANYSIZE_ARRAY]

Массив структур ACPI_METHOD_ARGUMENT.

Замечания

Драйвер для устройства может использовать запрос IOCTL_ACPI_EVAL_METHOD_EX или запрос IOCTL_ACPI_ASYNC_EVAL_METHOD_EX для оценки метода управления, который является дочерним объектом устройства. Если метод принимает сложный массив аргументов, эти запросы принимают входные ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX структуру следующим образом:

Задайте для подписи значение ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX.
Задайте MethodName строке, завершающей значение NULL, которая предоставляет полный путь и имя методу управления в пространстве имен ACPI или пути и имени метода относительно устройства, на которое отправляется запрос на оценку.
Например, предположим, что запрос отправляется на устройство с именем ABCD, которое является непосредственным дочерним элементом корневого пространства имен ACPI, что устройство ABCD поддерживает дочернее устройство с именем CHLD, и что устройство CHLD поддерживает метод с именем "_FOO". В этом случае запрос на оценку может указать "\ABCD". CHLD._FOO," — это полный путь и имя метода управления в пространстве имен ACPI или "CHLD._FOO", который представляет собой путь и имя метода управления, относящееся к устройству ABCD в пространстве имен ACPI.

Дополнительные сведения о том, как получить полный путь и имя метода управления в пространстве имен ACPI, см. в разделе Перечисление дочерних устройств и методов управления.
размер задано число байтов в массиве аргументов.
ArgumentCount задано число аргументов в массиве аргументов .
аргумент имеет массив структур ACPI_METHOD_ARGUMENT.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista и более поздних версий Windows.
заголовка	acpiioct.h (include Acpiioct.h)

См. также

ACPI_METHOD_ARGUMENT

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX

Поделиться через