IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL (usbioctl.h)
Los controladores usan la IOCTL_INTERNAL_USB_GET_HUB_NAME solicitud de E/S para recuperar el nombre simbólico UNICODE del PDO de destino si el PDO es para un centro. De lo contrario, se devuelve una cadena NULL.
Los controladores pueden usar el nombre simbólico para recuperar información adicional sobre el centro a través de solicitudes de control de E/S en modo de usuario y llamadas WMI.
IOCTL_INTERNAL_USB_GET_HUB_NAME es una solicitud de control de E/S en modo kernel. Esta solicitud tiene como destino el PDO del concentrador USB. Esta solicitud debe enviarse en un IRQL de PASSIVE_LEVEL.
Código principal
IRP_MJ_INTERNAL_DEVICE_CONTROL
Búfer de entrada
Irp->AssociatedIrp.SystemBuffer apunta a una estructura de USB_HUB_NAME.
Longitud del búfer de entrada
Parameters.DeviceIoControl.OutputBufferLength es la longitud del búfer (en bytes) pasado en el campo Irp->AssociatedIrp.SystemBuffer.
Búfer de salida
Irp->associatedIrp.SystemBuffer se rellena con el nombre simbólico del centro raíz.
Longitud del búfer de salida
Longitud del nombre simbólico del centro raíz.
Bloque de estado
Un controlador de nivel inferior establece Irp->IoStatus.Status en STATUS_SUCCESS o el estado de error adecuado. Establecerá Irp->IoStatus.Information en el número de bytes necesarios para contener la estructura de USB_ROOT_HUB_NAME. Si se produce un error en la solicitud, el controlador puede usar esta información para volver a enviar la solicitud con un búfer lo suficientemente grande.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | usbioctl.h (incluya Usbioctl.h) |