IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)
A solicitação IOCTL_USB_GET_NODE_CONNECTION_INFORMATION recupera informações sobre a porta USB indicada e o dispositivo anexado à porta, se houver uma.
Os drivers de cliente devem enviar esse IOCTL em um IRQL de PASSIVE_LEVEL.
IOCTL_USB_GET_NODE_CONNECTION_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
Buffer de entrada
O membro AssociatedIrp.SystemBuffer aponta para uma estrutura de USB_NODE_CONNECTION_INFORMATION alocada pelo usuário que descreve a conexão. Na entrada, o membro ConnectionIndex dessa estrutura contém o número da porta.
Comprimento do buffer de entrada
O tamanho de uma estrutura USB_NODE_CONNECTION_INFORMATION .
Buffer de saída
Na saída, o membro Parameters.DeviceIoControl.OutputBufferLength contém o tamanho dos dados de saída. Esse tamanho é variável, pois depende do número de pipes associados à porta.
AssociatedIrp.SystemBuffer aponta para uma estrutura de USB_NODE_CONNECTION_INFORMATION alocada pelo usuário que contém os dados de saída.
Comprimento do buffer de saída
O tamanho de uma estrutura USB_NODE_CONNECTION_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 define Status como a condição de erro apropriada, como STATUS_INVALID_PARAMETER ou STATUS_INSUFFICIENT_RESOURCES.
Comentários
A solicitação IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX é uma versão estendida do IOCTL_USB_GET_NODE_CONNECTION_INFORMATION. As duas solicitações são idênticas, exceto que a versão estendida da solicitação pode relatar conexões de baixa, completa e alta velocidade e os relatórios de solicitação de IOCTL_USB_GET_NODE_CONNECTION_INFORMATION mais antigos apenas conexões de baixa e velocidade total. Para obter mais informações sobre a diferença entre essas duas solicitações, consulte USB_NODE_CONNECTION_INFORMATION e USB_NODE_CONNECTION_INFORMATION_EX.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | usbioctl.h (inclua Usbioctl.h) |
Confira também
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX