Share via

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

  • Статья

Структура ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX используется в качестве входных данных для запроса IOCTL_ACPI_EVAL_METHOD_EX и запроса IOCTL_ACPI_ASYNC_EVAL_METHOD_EX . Структура предоставляет путь и имя метода элемента управления в пространстве имен ACPI и входной аргумент, представляющий собой строку ASCII.

Синтаксис

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX {
  ULONG Signature;
  CHAR  MethodName[256];
  ULONG StringLength;
  UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX;

Члены

Signature

Сигнатура расширенного входного буфера строки, для ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX.

MethodName[256]

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

StringLength

Число символов ASCII в массиве символов, предоставленном строкой.

String[ANYSIZE_ARRAY]

Массив символов ASCII, содержащий количество символов, заданное StringLength. Массив символов не содержит признак конца NULL.

Комментарии

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

  • Задайте для ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX значение Подписи .
  • Присвойте methodName строке с завершением NULL, которая предоставляет либо полный путь и имя методу элемента управления в пространстве имен ACPI, либо путь и имя метода, относящееся к устройству, на которое отправляется запрос на оценку.

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

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

  • Задайте для StringLength количество символов в строке String.
  • Задайте для параметра Строка входную строку.
Дополнительные сведения об использовании этой структуры см. в разделе Оценка методов управления ACPI.

Требования

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

См. также раздел

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX