struttura ACPI_ENUM_CHILD (acpiioct.h)
La struttura ACPI_ENUM_CHILD è un membro della struttura ACPI_ENUM_CHILDREN_OUTPUT_BUFFER e contiene il percorso completo e il nome di un oggetto in uno spazio dei nomi ACPI.
Sintassi
typedef struct _ACPI_ENUM_CHILD {
ULONG Flags;
ULONG NameLength;
CHAR Name[ANYSIZE_ARRAY];
} ACPI_ENUM_CHILD;
Membri
Flags
Valore flag impostato dal driver ACPI su ACPI_OBJECT_HAS_CHILDREN se l'oggetto figlio enumerato ha oggetti figlio; in caso contrario, il driver ACPI non imposta questo valore.
NameLength
Numero di caratteri, incluso un carattere con terminazione NULL, nella stringa ASCII contenuta nella matrice Nome.
Name[ANYSIZE_ARRAY]
Stringa ASCII con terminazione NULL contenente il percorso e il nome di un oggetto in uno spazio dei nomi ACPI. Per altre informazioni sul formato del percorso e del nome, vedere la sezione Osservazioni più avanti in questo argomento.
Osservazioni
Un driver per un dispositivo usa una richiesta di IOCTL_ACPI_ENUM_CHILDREN per enumerare gli oggetti figlio del dispositivo. Gli oggetti figlio enumerati possono essere dispositivi o qualsiasi oggetto di un nome specificato. Questa richiesta restituisce una struttura ACPI_ENUM_CHILDREN_OUTPUT_BUFFER, che include il membro Children che contiene una matrice di strutture ACPI_ENUM_CHILD.
Il percorso e il nome contenuti in un membro Nome sono nel formato standard per un percorso completo e il nome di un oggetto in uno spazio dei nomi ACPI. Si supponga, ad esempio, che un dispositivo denominato "ABCD" sia un elemento figlio immediato della radice di uno spazio dei nomi ACPI, che il dispositivo 'ABCD' abbia un dispositivo figlio denominato "CHLD" e che il dispositivo figlio "CHLD" abbia un oggetto figlio immediato denominato "_FOO". In questo caso, Nome conterrà '\ABCD. CHLD._FOO."
Per informazioni su come enumerare gli oggetti figlio di un dispositivo, vedere enumerazione di dispositivi figlio e metodi di controllo.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista e versioni successive di Windows. |
| intestazione | acpioct.h (include Acpiioct.h) |