estrutura ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1 (acpiioct.h)

  • Artigo

A estrutura ACPI_EVAL_INPUT_BUFFER_COMPLEX é 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 uma matriz de entrada de estruturas de ACPI_METHOD_ARGUMENT .

Sintaxe

typedef struct _ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1 {
  ULONG                   Signature;
  union {
    UCHAR MethodName[4];
    ULONG MethodNameAsUlong;
  } DUMMYUNIONNAME;
  ULONG                   Size;
  ULONG                   ArgumentCount;
  ACPI_METHOD_ARGUMENT_V1 Argument[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_V1, ACPI_EVAL_INPUT_BUFFER_COMPLEX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX;

Membros

Signature

A assinatura de um buffer de entrada complexo, que deve ser definido como ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE.

DUMMYUNIONNAME

DUMMYUNIONNAME.MethodName[4]

Uma matriz de caracteres ASCII de quatro elementos que contém o nome do método . Por exemplo, "ABCD".

DUMMYUNIONNAME.MethodNameAsUlong

Um valor 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'.

Size

O número de bytes que a matriz Argument contém.

ArgumentCount

O número de estruturas de ACPI_METHOD_ARGUMENT de comprimento variável que a matriz Argument contém. A matriz Argument pode conter no máximo sete estruturas de argumento.

Argument[ANYSIZE_ARRAY]

Uma matriz de estruturas de ACPI_METHOD_ARGUMENT.

Comentários

Se um dispositivo der suporte a um método de controle chamado 'ABCD' que usa uma matriz de argumentos como entrada, um driver para o dispositivo pode avaliar o método enviando uma solicitação de 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_COMPLEX de entrada da seguinte maneira:

  • Defina Assinatura como ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE.
  • Defina MethodName como 'ABCD' ou MethodNameAsUlong como (ULONG)('DCBA').
  • Defina Tamanho como o número de bytes na matriz Argument .
  • Defina Contagem de argumentos como o número de argumentos na matriz Argument .
  • Defina Argument como a matriz de estruturas de ACPI_METHOD_ARGUMENT.
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 (inclua Acpiioct.h)

Confira também

ACPI_METHOD_ARGUMENT

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD