IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL (usbioctl.h)
A solicitação de E/ S IOCTL_INTERNAL_USB_GET_HUB_NAME é usada por drivers para recuperar o nome simbólico UNICODE para o PDO de destino se o PDO for para um hub. Caso contrário, uma cadeia de caracteres NULL será retornada.
Os drivers podem usar o nome simbólico para recuperar informações adicionais sobre o hub por meio de solicitações de controle de E/S no modo de usuário e chamadas WMI.
IOCTL_INTERNAL_USB_GET_HUB_NAME é uma solicitação de controle de E/S no modo kernel. Essa solicitação tem como destino o PDO do hub USB. Essa solicitação deve ser enviada em um IRQL de PASSIVE_LEVEL.
Código principal
IRP_MJ_INTERNAL_DEVICE_CONTROL
Buffer de entrada
Irp->AssociatedIrp.SystemBuffer aponta para uma estrutura de USB_HUB_NAME .
Comprimento do buffer de entrada
Parameters.DeviceIoControl.OutputBufferLength é o comprimento do buffer (em bytes) passado no campo Irp-AssociatedIrp.SystemBuffer>.
Buffer de saída
Irp->AssociatedIrp.SystemBuffer é preenchido com o nome simbólico do hub raiz.
Comprimento do buffer de saída
O comprimento do nome simbólico do hub raiz.
Bloco de status
Um driver de nível inferior define Irp-IoStatus.Status> como STATUS_SUCCESS ou o erro apropriado status. Ele definirá Irp-IoStatus.Information> com o número de bytes necessários para manter a estrutura USB_ROOT_HUB_NAME. Se a solicitação falhar, o driver poderá usar essas informações para reenviar a solicitação com um buffer grande o suficiente.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | usbioctl.h (inclua Usbioctl.h) |