IOCTL_INTERNAL_USB_GET_HUB_NAME

Operation

Drivers can use this request to get the device name of the USB hub. This IOCTL must be sent at an IRQL of PASSIVE_LEVEL.

Input

Parameters.DeviceIoControl.OutputBufferLength is the length of the buffer (in bytes) passed in the Irp->AssociatedIrp.SystemBuffer field.

Irp->AssociatedIrp.SystemBuffer points to a USB_ROOT_HUB_NAME structure.

Output

Irp->AssociatedIrp.SystemBuffer is filled with the root hub's symbolic name.

I/O Status Block

A lower-level driver sets Irp->IoStatus.Status to STATUS_SUCCESS or the appropriate error status. It will set Irp->IoStatus.Information to the number of bytes required to hold the USB_ROOT_HUB_NAME structure. If the request fails, the driver can use this information to resubmit the request with a big enough buffer.

Headers

Defined in usbioctl.h. Include usbioctl.h.

See Also

USB_ROOT_HUB_NAME