structure ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 (acpiioct.h)

La structure ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING est utilisée comme entrée à une demande de IOCTL_ACPI_EVAL_METHOD et à une demande de IOCTL_ACPI_ASYNC_EVAL_METHOD. La structure fournit le nom d’une méthode de contrôle et un argument d’entrée qui est une chaîne ASCII.

Syntaxe

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;

Membres

Signature

Signature d’une mémoire tampon d’entrée de chaîne, qui doit être définie sur ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.

DUMMYUNIONNAME

DUMMYUNIONNAME.MethodName[4]

Ce membre de l’union est un tableau de caractères ASCII à quatre éléments qui contient le nom de la méthode. Par exemple, « ABCD ».

DUMMYUNIONNAME.MethodNameAsUlong

Ce membre de l’union est une variable typée ULONG qui contient le nom de la méthode au format (ULONG) ('DCBA'), où le nom de la méthode est le tableau de caractères ASCII à quatre éléments 'ABCD'.

StringLength

Nombre de caractères ASCII dans le tableau de caractères fourni par String.

String[ANYSIZE_ARRAY]

Chaîne de caractères ASCII qui contient le nombre de caractères spécifiés par StringLength. La chaîne n’inclut pas de terminateur NULL.

Remarques

Si un appareil prend en charge une méthode de contrôle nommée ABCD qui accepte une chaîne ASCII comme entrée, un pilote pour l’appareil peut évaluer la méthode en envoyant une demande de IOCTL_ACPI_EVAL_METHOD ou une demande de IOCTL_ACPI_ASYNC_EVAL_METHOD à l’appareil et en définissant les membres de la structure d’entrée ACPI_EVAL_INPUT_BUFFER comme suit :

• Définissez signature sur ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.
• Définissez MethodName sur « ABCD » ou MethodNameAsUlong sur (ULONG)('DCBA').
• Définissez StringLength sur le nombre de caractères fournis par String .
• Définissez chaîne sur la chaîne d’entrée.

Exigences

Voir aussi

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD