estructura ACPI_ENUM_CHILD (acpiioct.h)
La estructura ACPI_ENUM_CHILD es miembro de la estructura de ACPI_ENUM_CHILDREN_OUTPUT_BUFFER y contiene la ruta de acceso completa y el nombre de un objeto en un espacio de nombres ACPI.
Sintaxis
typedef struct _ACPI_ENUM_CHILD {
ULONG Flags;
ULONG NameLength;
CHAR Name[ANYSIZE_ARRAY];
} ACPI_ENUM_CHILD;
Miembros
Flags
Valor de marca que el controlador ACPI establece en ACPI_OBJECT_HAS_CHILDREN si el objeto secundario enumerado tiene objetos secundarios; de lo contrario, el controlador ACPI no establece este valor.
NameLength
Número de caracteres, incluido un carácter terminado en NULL, en la cadena ASCII que contiene la matriz Name .
Name[ANYSIZE_ARRAY]
Cadena ASCII terminada en NULL que contiene la ruta de acceso y el nombre de un objeto en un espacio de nombres ACPI. Para obtener más información sobre el formato de la ruta de acceso y el nombre, vea la sección Comentarios más adelante en este tema.
Comentarios
Un controlador de un dispositivo usa una solicitud de IOCTL_ACPI_ENUM_CHILDREN para enumerar los objetos secundarios del dispositivo. Los objetos secundarios enumerados pueden ser dispositivos o cualquier objeto de un nombre proporcionado. Esta solicitud devuelve una estructura ACPI_ENUM_CHILDREN_OUTPUT_BUFFER, que incluye el miembro Children que contiene una matriz de estructuras de ACPI_ENUM_CHILD.
La ruta de acceso y el nombre contenidos en un miembro Name están en el formato estándar para una ruta de acceso completa y el nombre de un objeto en un espacio de nombres ACPI. Por ejemplo, supongamos que un dispositivo denominado "ABCD" es un elemento secundario inmediato de la raíz de un espacio de nombres ACPI, que el dispositivo "ABCD" tiene un dispositivo secundario denominado "CHLD" y que el dispositivo secundario "CHLD" tiene un objeto secundario inmediato denominado "_FOO". En este caso, Name contendrá '\ABCD. CHLD._FOO.'
Para obtener información sobre cómo enumerar objetos secundarios de un dispositivo, vea Enumerar dispositivos secundarios y métodos de control.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista y versiones posteriores de Windows. |
| Encabezado | acpiioct.h (include Acpiioct.h) |