ACPI_ENUM_CHILD-Struktur (acpiioct.h)
Die ACPI_ENUM_CHILD-Struktur ist ein Member der ACPI_ENUM_CHILDREN_OUTPUT_BUFFER-Struktur und enthält den vollständigen Pfad und Namen eines Objekts in einem ACPI-Namespace.
Syntax
typedef struct _ACPI_ENUM_CHILD {
ULONG Flags;
ULONG NameLength;
CHAR Name[ANYSIZE_ARRAY];
} ACPI_ENUM_CHILD;
Member
Flags
Ein Flagwert, den der ACPI-Treiber auf ACPI_OBJECT_HAS_CHILDREN festlegt, wenn das aufgezählte untergeordnete Objekt über untergeordnete Objekte verfügt; Andernfalls legt der ACPI-Treiber diesen Wert nicht fest.
NameLength
Die Anzahl der Zeichen, einschließlich eines NULL-Endzeichens, in der ASCII-Zeichenfolge, die das Name-Array enthält.
Name[ANYSIZE_ARRAY]
Eine MIT NULL endende ASCII-Zeichenfolge, die den Pfad und den Namen eines Objekts in einem ACPI-Namespace enthält. Weitere Informationen zum Format des Pfads und namens finden Sie weiter unten in diesem Thema im Abschnitt Hinweise.
Hinweise
Ein Treiber für ein Gerät verwendet eine IOCTL_ACPI_ENUM_CHILDREN-Anforderung , um die untergeordneten Objekte des Geräts aufzulisten. Bei den aufgezählten untergeordneten Objekten kann es sich um Geräte oder ein beliebiges Objekt mit einem angegebenen Namen handeln. Diese Anforderung gibt eine ACPI_ENUM_CHILDREN_OUTPUT_BUFFER-Struktur zurück, die den Children-Member enthält, der ein Array von ACPI_ENUM_CHILD-Strukturen enthält.
Der Pfad und der Name, die in einem Name-Member enthalten sind, haben das Standardformat für einen vollqualifizierten Pfad und den Namen eines Objekts in einem ACPI-Namespace. Angenommen, ein Gerät mit dem Namen "ABCD" ist ein unmittelbares untergeordnetes Element des Stamms eines ACPI-Namespace, dass das Gerät "ABCD" ein untergeordnetes Gerät namens "CHLD" aufweist und dass das untergeordnete Gerät "CHLD" ein unmittelbar untergeordnetes Objekt namens "_FOO" aufweist. In diesem Fall würde Name "\ABCD" enthalten. CHLD._FOO."
Informationen zum Auflisten untergeordneter Objekte eines Geräts finden Sie unter Auflisten untergeordneter Geräte und Steuerungsmethoden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista und höhere Versionen von Windows. |
| Kopfzeile | acpiioct.h (include Acpiioct.h) |