ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX structure (acpiioct.h)

La structure ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX est utilisée comme entrée à une demande IOCTL_ACPI_EVAL_METHOD_EX et à une demande 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 tableau d’arguments d’entrée de structures ACPI_METHOD_ARGUMENT .

Syntaxe

typedef struct _ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX {
  ULONG                   Signature;
  CHAR                    MethodName[256];
  ULONG                   Size;
  ULONG                   ArgumentCount;
  ACPI_METHOD_ARGUMENT_V1 Argument[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_EX;

Membres

Signature

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

MethodName[256]

Chaîne ASCII terminée par NULL qui contient le chemin 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 une marque de fin NULL, est de 256.

Pour plus d’informations sur la façon de fournir le chemin et le nom d’une méthode de contrôle, consultez la section Remarques plus loin dans cette rubrique.

Size

Nombre d’octets que contient le tableau d’arguments .

ArgumentCount

Nombre de structures ACPI_METHOD_ARGUMENT de longueur variable que contient le tableau d’arguments . Le tableau d’arguments peut contenir un maximum de sept structures d’arguments.

Argument[ANYSIZE_ARRAY]

Tableau de structures ACPI_METHOD_ARGUMENT.

Remarques

Un pilote pour un appareil peut utiliser une demande de 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 tableau complexe d’arguments, ces requêtes prennent une structure d’entrée ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX comme suit :

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

  Par exemple, supposons qu’une requête soit 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 d’appareils enfants et méthodes de contrôle.

• Size est défini sur le nombre d’octets dans le tableau d’arguments .
• ArgumentCount est défini sur le nombre d’arguments dans le tableau d’arguments .
• Argument est défini sur un tableau de structures ACPI_METHOD_ARGUMENT.

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

ACPI_METHOD_ARGUMENT

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX