IOCTL_ACPI_ENUM_CHILDREN IOCTL (acpiioct.h)
La solicitud de control de dispositivos IOCTL_ACPI_ENUM_CHILDREN se puede usar para enumerar la ruta de acceso y el nombre de los dispositivos o objetos secundarios con nombre en el espacio de nombres ACPI del dispositivo al que se envía esta solicitud. Un controlador debe llamar a IoBuildDeviceIoControlRequest y pasar los siguientes parámetros de entrada y salida para compilar esta solicitud.
Código principal
Búfer de entrada
Establezca los parámetros de entrada IoBuildDeviceIoControlRequest de la siguiente manera:
- IoControlCode se establece en IOCTL_ACPI_ENUM_CHILDREN.
- DeviceObject se establece en un puntero al objeto de dispositivo físico (PDO) del dispositivo.
- InputBuffer se establece en un puntero a una estructura de ACPI_ENUM_CHILDREN_INPUT_BUFFER de longitud variable.
- InputBufferLength se establece en el tamaño, en bytes, del búfer de entrada proporcionado por InputBuffer.
- OutputBufferLength proporciona el tamaño, en bytes, del búfer de salida proporcionado por OutputBuffer.
- InternalDeviceIoControl se establece en FALSE.
- El evento se establece en un puntero a un objeto de evento asignado por el autor de la llamada e inicializado.
Longitud del búfer de entrada
InputBufferLength se establece en el tamaño, en bytes, del búfer de entrada proporcionado por InputBuffer.
Búfer de salida
Establezca los parámetros de salida IoBuildDeviceIoControlRequest de la siguiente manera:
- OutputBuffer proporciona un puntero a una estructura ACPI_ENUM_CHILDREN_OUTPUT_BUFFER de longitud variable en la que el controlador ACPI devuelve la ruta de acceso y el nombre de los dispositivos secundarios enumerados.
- IoStatusBlock se establece en una estructura de IO_STATUS_BLOCK .
Longitud del búfer de salida
OutputBufferLength proporciona el tamaño, en bytes, del búfer de salida proporcionado por OutputBuffer.
Bloque de estado
Si la solicitud se realiza correctamente, IoStatusBlock-Status> se establece en STATUS_SUCCESS; de lo contrario, el miembro Status se establece en un código de error. Si el búfer de salida no es lo suficientemente grande como para contener el encabezado del búfer, el miembro Status se establece en STATUS_BUFFER_TOO_SMALL. Si el búfer de salida es lo suficientemente grande como para contener el encabezado del búfer de salida, pero no es lo suficientemente grande como para contener las rutas de acceso y los nombres de todos los objetos secundarios enumerados, el miembro Status se establece en STATUS_BUFFER_OVERFLOW y OutputBuffer-NumberOfChildren> se establece en la longitud necesaria del búfer de salida.
Si la solicitud se realiza correctamente, el miembro IoStatusBlock-Information> se establece en el número de bytes devueltos en el búfer de salida; de lo contrario, el miembro Information se establece en cero.
Comentarios
IOCTL_ACPI_ENUM_CHILDREN devuelve una estructura ACPI_ENUM_CHILDREN_OUTPUT_BUFFER de longitud variable que contiene una matriz de estructuras ACPI_ENUM_CHILD de longitud variable, cada una de las cuales devuelve la ruta de acceso completa y el nombre de un objeto en el espacio de nombres ACPI del dispositivo al que se envió la solicitud. Los objetos que enumera esta solicitud dependen del valor del miembro Flags de la estructura de entrada proporcionada ACPI_ENUM_CHILDREN_INPUT_BUFFER, como se indica a continuación:
Si el búfer de salida que asigna el controlador no es lo suficientemente grande como para devolver todos los nombres secundarios solicitados, el controlador ACPI no devuelve ningún nombre secundario y establece el miembro Status del IO_STATUS_BLOCK para que la solicitud STATUS_BUFFER_OVERFLOW. En este caso, si el tamaño, en bytes, del búfer de salida es al menos sizeof(ACPI_ENUM_CHILDREN_OUTPUT_BUFFER_SIGNATURE), el controlador ACPI también establece NumberOfChildren en el tamaño, en bytes, necesario para recuperar las rutas de acceso y los nombres solicitados.
Normalmente, un controlador usaría una secuencia de dos solicitudes de IOCTL_ACPI_ENUM_CHILDREN para enumerar los objetos secundarios de interés. El controlador envía la primera solicitud para obtener el tamaño del búfer de salida necesario para contener la ruta de acceso y el nombre de todos los objetos solicitados. El controlador envía la segunda solicitud para devolver la ruta de acceso y el nombre de los objetos en el búfer de salida.
Para obtener más información sobre cómo enumerar dispositivos secundarios de un dispositivo, vea Enumerar dispositivos secundarios y métodos de control.
IOCTL_ACPI_ENUM_CHILDREN solo se puede usar en irQL< DISPATCH_LEVEL.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista y versiones posteriores de Windows. |
| Encabezado | acpiioct.h (include Acpiioct.h) |