ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 estrutura (acpiioct.h)

Artigo
02/06/2025

A estrutura de 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 da 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 da 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 pelo 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.

Observações

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 IOCTL_ACPI_EVAL_METHOD ou uma solicitação 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 de Assinatura como ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.
Defina MethodName como 'ABCD' ou MethodNameAsUlong como (ULONG)('DCBA').
Defina StringLength com o número de caracteres fornecidos por String.
Defina cadeia de caracteres para a cadeia de caracteres de entrada.

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

Requisitos

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

Consulte também

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD

Compartilhar via