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;

Members

Flags

Valore del flag impostato dal driver ACPI su ACPI_OBJECT_HAS_CHILDREN se l'oggetto figlio enumerato dispone di 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 Name .

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.

Commenti

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 Name 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 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, Name conterrà '\ABCD. CHLD._FOO'.

Per informazioni su come enumerare gli oggetti figlio di un dispositivo, vedere Enumerazione di dispositivi figlio e metodi di controllo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista e versioni successive di Windows.
Intestazione	acpiioct.h (include Acpiioct.h)

Vedi anche

ACPI_ENUM_CHILDREN_OUTPUT_BUFFER

IOCTL_ACPI_ENUM_CHILDREN