структура ACPI_EVAL_INPUT_BUFFER_V1_EX (acpiioct.h)
Структура ACPI_EVAL_INPUT_BUFFER_EX используется в качестве входных данных для запроса IOCTL_ACPI_EVAL_METHOD_EX и запроса IOCTL_ACPI_ASYNC_EVAL_METHOD_EX . Структура предоставляет путь и имя метода управления в пространстве имен ACPI, которое не принимает входной аргумент.
Синтаксис
typedef struct _ACPI_EVAL_INPUT_BUFFER_V1_EX {
ULONG Signature;
CHAR MethodName[256];
} ACPI_EVAL_INPUT_BUFFER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_V1_EX, ACPI_EVAL_INPUT_BUFFER_EX, *PACPI_EVAL_INPUT_BUFFER_EX;
Члены
Signature
Сигнатура входного буфера, не включающая аргумент, для которого необходимо задать значение ACPI_EVAL_INPUT_BUFFER_SIGNATURE_EX.
MethodName[256]
Строка ASCII, завершающаяся null, которая содержит путь и имя метода элемента управления в пространстве имен ACPI. Максимальное количество символов, которое может содержать строка, включая символ конца NULL, равно 256. Дополнительные сведения о том, как указать путь и имя метода элемента управления, см. в разделе Примечания далее в этом разделе.
Комментарии
Драйвер для устройства может использовать запрос IOCTL_ACPI_EVAL_METHOD_EX или запрос IOCTL_ACPI_ASYNC_EVAL_METHOD_EX для оценки метода управления, который является потомком дочернего объекта устройства. Если метод не принимает входные аргументы, эти запросы принимают входные данные ACPI_EVAL_INPUT_BUFFER_EX структуре следующим образом:
- Задайте для свойства Подпись значение ACPI_EVAL_INPUT_BUFFER_SIGNATURE_EX.
-
Задайте для MethodName строку, завершающуюся значением NULL, которая предоставляет полный путь и имя для метода управления в пространстве имен ACPI или путь и имя метода, относящееся к устройству, на которое отправляется запрос на оценку.
Например, предположим, что запрос отправляется на устройство с именем "ABCD", которое является непосредственным дочерним элементом корня пространства имен ACPI, что устройство ABCD поддерживает дочернее устройство с именем "CHLD", а устройство "CHLD" поддерживает метод с именем "_FOO". В этом случае запрос на оценку может предоставить либо \ABCD. CHLD._FOO, представляющий собой полный путь и имя метода элемента управления в пространстве имен ACPI, или "CHLD._FOO", который представляет собой путь и имя метода управления, относящееся к устройству "ABCD" в пространстве имен ACPI.
Дополнительные сведения о том, как получить полный путь и имя метода элемента управления в пространстве имен ACPI, см. в разделе Перечисление дочерних устройств и методов управления.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista и более поздние версии Windows. |
| Верхняя часть | acpiioct.h (включая Acpiioct.h) |