estructura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 (acpiioct.h)

La estructura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING se usa como entrada para una solicitud IOCTL_ACPI_EVAL_METHOD y para una solicitud de IOCTL_ACPI_ASYNC_EVAL_METHOD. La estructura proporciona el nombre de un método de control y un argumento de entrada que es una cadena ASCII.

Sintaxis

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;

Miembros

Signature

Firma de un búfer de entrada de cadena, que se debe establecer en ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.

DUMMYUNIONNAME

DUMMYUNIONNAME.MethodName[4]

Este miembro de unión es una matriz de caracteres ASCII de cuatro elementos que contiene el nombre del método. Por ejemplo, "ABCD".

DUMMYUNIONNAME.MethodNameAsUlong

Este miembro de unión es una variable con tipo ULONG que contiene el nombre del método con el formato (ULONG) ('DCBA'), donde el nombre del método es la matriz de caracteres ASCII de cuatro elementos 'ABCD'.

StringLength

Número de caracteres ASCII en la matriz de caracteres proporcionados por String.

String[ANYSIZE_ARRAY]

Cadena de caracteres ASCII que contiene el número de caracteres especificados por StringLength. La cadena no incluye un terminador NULL.

Observaciones

Si un dispositivo admite un método de control denominado ABCD que toma una cadena ASCII como entrada, un controlador para el dispositivo puede evaluar el método enviando una solicitud de IOCTL_ACPI_EVAL_METHOD o una solicitud de IOCTL_ACPI_ASYNC_EVAL_METHOD al dispositivo y estableciendo los miembros de la estructura de entrada ACPI_EVAL_INPUT_BUFFER de la siguiente manera:

• Establezca firma en ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.
• Establezca MethodName en "ABCD" o MethodNameAsUlong en (ULONG)("DCBA").
• Establezca StringLength en el número de caracteres proporcionados por string.
• Establezca cadena en la cadena de entrada.

Requisitos

Consulte también

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD