Поделиться через


структура 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)

См. также раздел

ACPI_ENUM_CHILDREN_OUTPUT_BUFFER

IOCTL_ACPI_ENUM_CHILDREN