structure ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX (acpiioct.h)

  • Article

La structure ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX est utilisée comme entrée dans une demande de IOCTL_ACPI_EVAL_METHOD_EX et dans une requête de IOCTL_ACPI_ASYNC_EVAL_METHOD_EX . La structure fournit le chemin d’accès et le nom d’une méthode de contrôle dans un espace de noms ACPI et un argument d’entrée de type ULONG64.

Syntaxe

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX {
  ULONG   Signature;
  CHAR    MethodName[256];
  ULONG64 IntegerArgument;
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX;

Membres

Signature

Signature d’une mémoire tampon d’entrée d’entier étendue, qui doit être définie sur ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EX.

MethodName[256]

Chaîne ASCII terminée par NULL qui contient le chemin d’accès et le nom d’une méthode de contrôle dans un espace de noms ACPI. Le nombre maximal de caractères que la chaîne peut contenir, y compris un point de terminaison NULL, est de 256. Pour plus d’informations sur la façon de fournir le chemin d’accès et le nom d’une méthode de contrôle, consultez la section Remarques plus loin dans cette rubrique.

IntegerArgument

Valeur d’argument de type ULONG64 passée en tant qu’entrée à la méthode de contrôle.

Remarques

Un pilote pour un appareil peut utiliser une requête IOCTL_ACPI_EVAL_METHOD_EX ou une demande de IOCTL_ACPI_ASYNC_EVAL_METHOD_EX pour évaluer une méthode de contrôle qui est un objet enfant descendant de l’appareil. Si la méthode prend un argument d’entrée entier unique, ces requêtes prennent une entrée ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX structure comme suit :

  • Définissez Signature sur ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EX.
  • Définissez MethodName sur une chaîne terminée par NULL qui fournit soit le chemin d’accès complet et le nom d’une méthode de contrôle dans l’espace de noms ACPI, soit le chemin et le nom de la méthode relative à l’appareil auquel la demande d’évaluation est envoyée.

    Par exemple, supposons qu’une demande est envoyée à un appareil nommé « ABCD », qui est un enfant immédiat de la racine d’un espace de noms ACPI, que l’appareil « ABCD » prend en charge un appareil enfant nommé « CHLD » et que l’appareil « CHLD » prend en charge une méthode nommée « _FOO ». Dans ce cas, la demande d’évaluation peut fournir ' \ABCD. CHLD._FOO », qui est le chemin complet et le nom de la méthode de contrôle dans l’espace de noms ACPI, ou « CHLD._FOO », qui est le chemin et le nom de la méthode de contrôle relative à l’appareil « ABCD » dans l’espace de noms ACPI.

    Pour plus d’informations sur la façon d’obtenir le chemin complet et le nom d’une méthode de contrôle dans un espace de noms ACPI, consultez Énumération des appareils enfants et des méthodes de contrôle.

  • Définissez IntegerArgument sur la valeur entière 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 Vista et versions ultérieures de Windows.
En-tête acpiioct.h (inclure Acpiioct.h)

Voir aussi

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX