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