Compartir a través de

estructura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 (acpiioct.h)

  • Artículo

La estructura de ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING se usa como entrada para una solicitud de 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 en 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.

Comentarios

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 ACPI_EVAL_INPUT_BUFFER de entrada 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 String en la cadena de entrada.
Para obtener más información sobre cómo usar esta estructura, vea Evaluación de métodos de control ACPI.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 y versiones posteriores de Windows.
Encabezado acpiioct.h (include Acpiioct.h)

Consulte también

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD