IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL (usbioctl.h)

  • Artigo

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)

Confira também

USB_ROOT_HUB_NAME