IOCTL_ACPI_ENUM_CHILDREN IOCTL (acpiioct.h)
O IOCTL_ACPI_ENUM_CHILDREN solicitação de controle de dispositivo pode ser usado para enumerar o caminho e o nome dos dispositivos ou objetos filho nomeados no namespace ACPI do dispositivo para o qual essa solicitação é enviada. Um driver deve chamar IoBuildDeviceIoControlRequest e passar os seguintes parâmetros de entrada e saída para compilar essa solicitação.
Código principal
Buffer de entrada
Defina os parâmetros de entrada IoBuildDeviceIoControlRequest da seguinte maneira:
- IoControlCode é definido como IOCTL_ACPI_ENUM_CHILDREN.
- DeviceObject é definido como um ponteiro para o PDO (objeto de dispositivo físico) do dispositivo.
- InputBuffer é definido como um ponteiro para uma estrutura ACPI_ENUM_CHILDREN_INPUT_BUFFER de comprimento variável.
- InputBufferLength é definido como o tamanho, em bytes, do buffer de entrada fornecido pelo InputBuffer.
- OutputBufferLength fornece o tamanho, em bytes, do buffer de saída fornecido pelo OutputBuffer.
- InternalDeviceIoControl é definido como FALSE.
- Event é definido como um ponteiro para um objeto de evento alocado pelo chamador e inicializado.
Comprimento do buffer de entrada
InputBufferLength é definido como o tamanho, em bytes, do buffer de entrada fornecido pelo InputBuffer.
Buffer de saída
Defina os parâmetros de saída IoBuildDeviceIoControlRequest da seguinte maneira:
- OutputBuffer fornece um ponteiro para uma estrutura ACPI_ENUM_CHILDREN_OUTPUT_BUFFER de comprimento variável na qual o driver ACPI retorna o caminho e o nome dos dispositivos filho enumerados.
- IoStatusBlock é definido como uma estrutura IO_STATUS_BLOCK .
Comprimento do buffer de saída
OutputBufferLength fornece o tamanho, em bytes, do buffer de saída fornecido pelo OutputBuffer.
Bloco de status
Se a solicitação for bem-sucedida, IoStatusBlock-Status> será definido como STATUS_SUCCESS; caso contrário, o membro Status será definido como um código de erro. Se o buffer de saída não for grande o suficiente para conter o cabeçalho do buffer, o membro Status será definido como STATUS_BUFFER_TOO_SMALL. Se o buffer de saída for grande o suficiente para conter o cabeçalho do buffer de saída, mas não for grande o suficiente para conter os caminhos e nomes de todos os objetos filho enumerados, o membro Status será definido como STATUS_BUFFER_OVERFLOW e OutputBuffer-NumberOfChildren> será definido como o comprimento necessário do buffer de saída.
Se a solicitação for bem-sucedida, o membro IoStatusBlock-Information> será definido como o número de bytes retornados no buffer de saída; caso contrário, o membro Information será definido como zero.
Comentários
IOCTL_ACPI_ENUM_CHILDREN retorna uma estrutura ACPI_ENUM_CHILDREN_OUTPUT_BUFFER de comprimento variável que contém uma matriz de estruturas de ACPI_ENUM_CHILD de comprimento variável, cada uma das quais retorna o caminho totalmente qualificado e o nome de um objeto no namespace ACPI do dispositivo para o qual a solicitação foi enviada. Os objetos que essa solicitação enumera dependem da configuração do membro Flags da estrutura de entrada fornecida ACPI_ENUM_CHILDREN_INPUT_BUFFER, da seguinte maneira:
Se o buffer de saída alocado pelo driver não for grande o suficiente para retornar todos os nomes filho solicitados, o driver ACPI não retornará nenhum nome filho e definirá o membro Status do IO_STATUS_BLOCK para que a solicitação STATUS_BUFFER_OVERFLOW. Nesse caso, se o tamanho, em bytes, do buffer de saída for pelo menos sizeof(ACPI_ENUM_CHILDREN_OUTPUT_BUFFER_SIGNATURE), o driver ACPI também definirá NumberOfChildren como o tamanho, em bytes, necessário para recuperar os caminhos e nomes solicitados.
Um driver normalmente usaria uma sequência de duas solicitações IOCTL_ACPI_ENUM_CHILDREN para enumerar os objetos filho de interesse. O driver envia a primeira solicitação para obter o tamanho do buffer de saída necessário para conter o caminho e o nome de todos os objetos solicitados. O driver envia a segunda solicitação para retornar o caminho e o nome dos objetos no buffer de saída.
Para obter mais informações sobre como enumerar dispositivos filho de um dispositivo, consulte Enumerando dispositivos filho e métodos de controle.
IOCTL_ACPI_ENUM_CHILDREN só podem ser usados em DISPATCH_LEVEL IRQL< .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista e versões posteriores do Windows. |
| Cabeçalho | acpiioct.h (include Acpiioct.h) |