IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)
A solicitação de controle de E/S IOCTL_USB_GET_ROOT_HUB_NAME é usada com a estrutura USB_ROOT_HUB_NAME para recuperar o nome simbólico do link do hub raiz.
IOCTL_USB_GET_ROOT_HUB_NAME é uma solicitação de controle de E/S no modo de usuário. Essa solicitação tem como destino o controlador de host USB (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).
Código principal
Buffer de entrada
Nenhum.
Comprimento do buffer de entrada
Nenhum.
Buffer de saída
Na saída, o membro AssociatedIrp.SystemBuffer aponta para uma estrutura USB_ROOT_HUB_NAME que contém o nome simbólico do link do hub raiz. O texto "\xxx\ " à esquerda não está incluído na cadeia de caracteres recuperada.
Comprimento do buffer de saída
O tamanho de uma estrutura USB_ROOT_HUB_NAME .
Bloco de status
A pilha USB define Irp-IoStatus.Status> como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, a pilha USB define Status como a condição de erro apropriada, como STATUS_INVALID_PARAMETER ou STATUS_INSUFFICIENT_RESOURCES.
Se o hub raiz for removido ou interrompido, a solicitação retornará STATUS_SUCCESS mas a cadeia de caracteres será NULL.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | usbioctl.h (inclua Usbioctl.h) |