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

Статья
02/06/2025

Структура 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.

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 (include Acpiioct.h)

См. также

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX

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