Compartilhar via

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

  • Artigo

A solicitação IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION recupera informações de faixa de super-velocidade da porta USB.

Os drivers cliente devem enviar esse IOCTL em um IRQL de PASSIVE_LEVEL.

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION é uma solicitação de controle de E/S no modo de usuário. Essa solicitação tem como destino o dispositivo de hub USB (GUID_DEVINTERFACE_USB_HUB).

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada/saída

Os buffers de entrada e saída apontam para uma estrutura de USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION alocada pelo chamador. Na entrada, o membro ConnectionIndex dessa estrutura deve conter um número maior ou igual a 1 que indique o número da porta cujas informações de faixa de super-velocidade devem ser relatadas. O driver do hub retorna informações sobre a faixa de velocidade nos membros restantes da estrutura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION . O IRP, o membro AssociatedIrp.SystemBuffer , aponta para a estrutura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION .

Na saída, a estrutura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION recebe informações sobre as faixas de superlocação indicadas do driver do hub USB.

Comprimento do buffer de entrada/saída

O tamanho de uma estrutura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION .

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 definirá Status como a condição de erro apropriada, como STATUS_INVALID_PARAMETER ou STATUS_INSUFFICIENT_RESOURCES.

Comentários

Aqui está um exemplo que mostra como recuperar as informações de faixa de super-velocidade da porta USB.

success = DeviceIoControl(hHubDevice,
                          IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION,
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          &nBytes,
                          NULL);

Requisitos

Requisito Valor
Cabeçalho usbioctl.h

Confira também