estrutura ACPI_ENUM_CHILD (acpiioct.h)

  • Artigo

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)

Confira também

ACPI_ENUM_CHILDREN_OUTPUT_BUFFER

IOCTL_ACPI_ENUM_CHILDREN