IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL (usbioctl.h)

Los controladores usan la solicitud de E/S de IOCTL_INTERNAL_USB_GET_HUB_NAME 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 suficientemente grande.

Requisitos

Requisito	Valor
Header	usbioctl.h (incluya Usbioctl.h)

Consulte también

USB_ROOT_HUB_NAME