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

Статья
02/06/2025

Структура ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING используется в качестве входных данных для запроса IOCTL_ACPI_EVAL_METHOD и запроса IOCTL_ACPI_ASYNC_EVAL_METHOD. Структура предоставляет имя метода управления и входной аргумент, который является строкой ASCII.

Синтаксис

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 {
  ULONG Signature;
  union {
    UCHAR MethodName[4];
    ULONG MethodNameAsUlong;
  } DUMMYUNIONNAME;
  ULONG StringLength;
  UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING;

Члены

Signature

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

DUMMYUNIONNAME

DUMMYUNIONNAME.MethodName[4]

Этот член объединения представляет собой массив символов ASCII с четырьмя элементами, который содержит имя метода. Например, "ABCD".

DUMMYUNIONNAME.MethodNameAsUlong

Этот член объединения представляет собой переменную типа ULONG, содержащую имя метода в формате (ULONG) (DCBA), где имя метода — это массив символов ASCII с четырьмя элементами "ABCD".

StringLength

Число символов ASCII в массиве символов, предоставляемых string.

String[ANYSIZE_ARRAY]

Строка символов ASCII, содержащая количество символов, указанное StringLength. Строка не включает терминатор NULL.

Замечания

Если устройство поддерживает метод управления с именем ABCD, который принимает строку ASCII в качестве входных данных, драйвер для устройства может оценить этот метод, отправив запрос IOCTL_ACPI_EVAL_METHOD или запрос IOCTL_ACPI_ASYNC_EVAL_METHOD на устройство и установив элементы входной ACPI_EVAL_INPUT_BUFFER структуры следующим образом:

Задайте для ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE подписи.
Задайте для имя_метода значение ABCD или MethodNameAsUlong (ULONG)('DCBA').
Задайте StringLength число символов, предоставленных строкой.
Задайте string входной строке.

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

Требования

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

См. также

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD

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