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.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 e versões posteriores do Windows. |
Cabeçalho | acpiioct.h (include Acpiioct.h) |