структура ACPI_ENUM_CHILD (acpiioct.h)
Структура ACPI_ENUM_CHILD является членом структуры ACPI_ENUM_CHILDREN_OUTPUT_BUFFER и содержит полный путь и имя объекта в пространстве имен ACPI.
Синтаксис
typedef struct _ACPI_ENUM_CHILD {
ULONG Flags;
ULONG NameLength;
CHAR Name[ANYSIZE_ARRAY];
} ACPI_ENUM_CHILD;
Члены
Flags
Значение флага, которое драйвер ACPI задает для ACPI_OBJECT_HAS_CHILDREN, если перечисляемый дочерний объект имеет дочерние объекты; В противном случае драйвер ACPI не задает это значение.
NameLength
Число символов в строке ASCII, содержащейся в массиве Имен , в том числе символа, заканчивающегося символом NULL.
Name[ANYSIZE_ARRAY]
Строка ASCII, заканчивающаяся null, которая содержит путь и имя объекта в пространстве имен ACPI. Дополнительные сведения о формате пути и имени см. в разделе Примечания далее в этом разделе.
Комментарии
Драйвер для устройства использует запрос IOCTL_ACPI_ENUM_CHILDREN для перечисления дочерних объектов устройства. Перечислимые дочерние объекты могут быть устройствами или любым объектом с указанным именем. Этот запрос возвращает структуру ACPI_ENUM_CHILDREN_OUTPUT_BUFFER, включающую элемент Children , содержащий массив ACPI_ENUM_CHILD структур.
Путь и имя, содержащиеся в элементе Name , имеют стандартный формат для полного пути и имени объекта в пространстве имен ACPI. Например, предположим, что устройство с именем "ABCD" является непосредственным дочерним элементом корня пространства имен ACPI, что устройство "ABCD" имеет дочернее устройство с именем "CHLD", а дочернее устройство "CHLD" имеет непосредственный дочерний объект с именем "_FOO". В этом случае имя будет содержать \ABCD. CHLD._FOO.
Сведения о перечислении дочерних объектов устройства см. в разделах Перечисление дочерних устройств и методов управления.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista и более поздние версии Windows. |
| Верхняя часть | acpiioct.h (включая Acpiioct.h) |