estrutura ACPI_ENUM_CHILD (acpiioct.h)
A estrutura ACPI_ENUM_CHILD é um membro da estrutura ACPI_ENUM_CHILDREN_OUTPUT_BUFFER e contém o caminho completo e o nome de um objeto em um namespace ACPI.
Sintaxe
typedef struct _ACPI_ENUM_CHILD {
ULONG Flags;
ULONG NameLength;
CHAR Name[ANYSIZE_ARRAY];
} ACPI_ENUM_CHILD;
Membros
Flags
Um valor de sinalizador que o driver ACPI define como ACPI_OBJECT_HAS_CHILDREN se o objeto filho enumerado tiver objetos filho; caso contrário, o driver ACPI não define esse valor.
NameLength
O número de caracteres, incluindo um caractere terminado em NULL, na cadeia de caracteres ASCII que a matriz Name contém.
Name[ANYSIZE_ARRAY]
Uma cadeia de caracteres ASCII terminada em NULL que contém o caminho e o nome de um objeto em um namespace ACPI. Para obter mais informações sobre o formato do caminho e do nome, consulte a seção Comentários mais adiante neste tópico.
Comentários
Um driver para um dispositivo usa uma solicitação IOCTL_ACPI_ENUM_CHILDREN para enumerar os objetos filho do dispositivo. Os objetos filho enumerados podem ser dispositivos ou qualquer objeto de um nome fornecido. Essa solicitação retorna uma estrutura ACPI_ENUM_CHILDREN_OUTPUT_BUFFER, que inclui o membro Children que contém uma matriz de estruturas ACPI_ENUM_CHILD.
O caminho e o nome contidos em um membro Name estão no formato padrão para um caminho totalmente qualificado e o nome de um objeto em um namespace ACPI. Por exemplo, suponha que um dispositivo chamado 'ABCD' seja um filho imediato da raiz de um namespace ACPI, que o dispositivo 'ABCD' tenha um dispositivo filho chamado 'CHLD', e que o dispositivo filho 'CHLD' tenha um objeto filho imediato chamado '_FOO'. Nesse caso, Name conteria '\ABCD. CHLD._FOO.
Para obter informações sobre como enumerar objetos filho de um dispositivo, consulte Enumerando dispositivos filho e métodos de controle.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista e versões posteriores do Windows. |
| Cabeçalho | acpiioct.h (inclua Acpiioct.h) |