IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)
A solicitação de controle de E/S IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES recupera os atributos de porta estendida pela Microsoft para uma porta específica.
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES é 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_ATTRIBUTES alocada pelo usuário. Na entrada, o chamador especifica o número da porta no connectionIndex membro de uma estrutura de USB_NODE_CONNECTION_ATTRIBUTES.
Comprimento do buffer de entrada
O tamanho de uma estrutura USB_NODE_CONNECTION_ATTRIBUTES.
Buffer de saída
Na saída, a estrutura USB_NODE_CONNECTION_ATTRIBUTES em AssociatedIrp.SystemBuffer descreve os atributos de porta estendida da Microsoft para a porta. Observação Para Windows Vista, Windows Server 2008 e Windows 7, o campo atributos de porta estendida da Microsoft está definido como zero.
Para Windows XP e Windows Server 2003, o atributo de porta estendida da Microsoft pode ser definido como USB_PORTATTR_NO_OVERCURRENT_UI. Esse valor indica que a interface do usuário ficará oculta quando ocorrer uma corrente excessiva na porta.
Comprimento do buffer de saída
Parameters.DeviceIoControl.OutputBufferLength indica o tamanho, em bytes, dos dados retornados em SystemBuffer.
Bloco de status
A pilha USB define Irp->IoStatus.Status para STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, a pilha USB define Status à condição de erro apropriada, como STATUS_INVALID_PARAMETER ou STATUS_INSUFFICIENT_RESOURCES. Se o hub não tiver sido iniciado ou não estiver funcional, a solicitação retornará STATUS_UNSUCCESSFUL.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP, Windows Server 2003 e posterior. |
| cabeçalho | usbioctl.h (include Usbioctl.h) |