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

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

  • Статья

Структура 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[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.
  • Задайте для свойства MethodName значение "ABCD", а имя_методаAsUlong — значение (ULONG)('DCBA').
  • Присвойте stringLength количество символов, предоставляемых строкой.
  • Задайте для параметра Строка входную строку.
Дополнительные сведения об использовании этой структуры см. в разделе Оценка методов управления ACPI.

Требования

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

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

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD