estrutura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 (acpiioct.h)

A estrutura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING é usada como entrada para uma solicitação de IOCTL_ACPI_EVAL_METHOD e para uma solicitação de IOCTL_ACPI_ASYNC_EVAL_METHOD . A estrutura fornece o nome de um método de controle e um argumento de entrada que é uma cadeia de caracteres ASCII.

Sintaxe

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;

Membros

Signature

A assinatura de um buffer de entrada de cadeia de caracteres, que deve ser definida como ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.

DUMMYUNIONNAME

DUMMYUNIONNAME.MethodName[4]

Esse membro de união é uma matriz de caracteres ASCII de quatro elementos que contém o nome do método. Por exemplo, "ABCD".

DUMMYUNIONNAME.MethodNameAsUlong

Esse membro de união é uma variável do tipo ULONG que contém o nome do método no formato (ULONG) ('DCBA'), em que o nome do método é a matriz de caracteres ASCII de quatro elementos 'ABCD'.

StringLength

O número de caracteres ASCII na matriz de caracteres fornecida por String.

String[ANYSIZE_ARRAY]

Uma cadeia de caracteres ASCII que contém o número de caracteres especificado por StringLength. A cadeia de caracteres não inclui um terminador NULL.

Comentários

Se um dispositivo der suporte a um método de controle chamado ABCD que usa uma cadeia de caracteres ASCII como entrada, um driver para o dispositivo poderá avaliar o método enviando uma solicitação de IOCTL_ACPI_EVAL_METHOD ou uma solicitação de IOCTL_ACPI_ASYNC_EVAL_METHOD para o dispositivo e definindo os membros da estrutura de ACPI_EVAL_INPUT_BUFFER de entrada da seguinte maneira:

• Defina Assinatura como ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.
• Defina MethodName como 'ABCD' ou MethodNameAsUlong como (ULONG)('DCBA').
• Defina StringLength como o número de caracteres fornecidos por String.
• Defina Cadeia de caracteres como a cadeia de caracteres de entrada.

Para obter mais informações sobre como usar essa estrutura, consulte Avaliando métodos de controle ACPI.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 e versões posteriores do Windows.
Cabeçalho	acpiioct.h (include Acpiioct.h)

Confira também

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD