structure ACPI_ENUM_CHILD (acpiioct.h)

La structure ACPI_ENUM_CHILD est membre de la structure ACPI_ENUM_CHILDREN_OUTPUT_BUFFER et contient le chemin d’accès complet et le nom d’un objet dans un espace de noms ACPI.

Syntaxe

typedef struct _ACPI_ENUM_CHILD {
  ULONG Flags;
  ULONG NameLength;
  CHAR  Name[ANYSIZE_ARRAY];
} ACPI_ENUM_CHILD;

Membres

Flags

Valeur d’indicateur que le pilote ACPI définit sur ACPI_OBJECT_HAS_CHILDREN si l’objet enfant énuméré a des objets enfants ; sinon, le pilote ACPI ne définit pas cette valeur.

NameLength

Nombre de caractères, y compris un caractère terminé par NULL, dans la chaîne ASCII que contient le tableau Name .

Name[ANYSIZE_ARRAY]

Chaîne ASCII terminée par null qui contient le chemin d’accès et le nom d’un objet dans un espace de noms ACPI. Pour plus d’informations sur le format du chemin d’accès et du nom, consultez la section Remarques plus loin dans cette rubrique.

Remarques

Un pilote pour un appareil utilise une requête IOCTL_ACPI_ENUM_CHILDREN pour énumérer les objets enfants de l’appareil. Les objets enfants énumérés peuvent être des appareils ou n’importe quel objet d’un nom fourni. Cette requête retourne une structure ACPI_ENUM_CHILDREN_OUTPUT_BUFFER, qui inclut le membre Children qui contient un tableau de structures ACPI_ENUM_CHILD.

Le chemin d’accès et le nom contenus dans un membre Name sont au format standard pour un chemin d’accès complet et le nom d’un objet dans un espace de noms ACPI. Par exemple, supposons qu’un appareil nommé « ABCD » est un enfant immédiat de la racine d’un espace de noms ACPI, que l’appareil « ABCD » a un appareil enfant nommé « CHLD » et que cet appareil enfant « CHLD » a un objet enfant immédiat nommé « _FOO ». Dans ce cas, Name contient '\ABCD. CHLD._FOO.

Pour plus d’informations sur l’énumération d’objets enfants d’un appareil, consultez Énumération d’appareils enfants et méthodes de contrôle.

Configuration requise

Voir aussi

ACPI_ENUM_CHILDREN_OUTPUT_BUFFER

IOCTL_ACPI_ENUM_CHILDREN