structure ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 (acpiioct.h)

Article
08/07/2023

La structure ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING est utilisée comme entrée dans une demande de IOCTL_ACPI_EVAL_METHOD et dans une requête 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 d’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 d’union est une variable de type 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é par StringLength. La chaîne n’inclut pas de terminaison NULL.

Remarques

Si un appareil prend en charge une méthode de contrôle nommée ABCD qui prend une chaîne ASCII comme entrée, un pilote de l’appareil peut évaluer la méthode en envoyant une demande de IOCTL_ACPI_EVAL_METHOD ou une demande 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 fourni par String.
Définissez String sur la chaîne d’entrée.

Pour plus d’informations sur l’utilisation de cette structure, consultez Évaluation des méthodes de contrôle ACPI.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 et versions ultérieures de Windows.
En-tête	acpiioct.h (inclure Acpiioct.h)

Voir aussi

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD

Partager via