IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)
O IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES solicitação de controle de E/S recupera os atributos de porta estendida da 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 membro ConnectionIndex de uma estrutura 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. Nota Para Windows Vista, Windows Server 2008 e Windows 7, o campo Atributos de porta estendida da Microsoft é definido como zero.
Para o Windows XP e o 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 um excesso de simultaneidade 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 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. Se o hub não tiver sido iniciado ou não estiver funcional, a solicitação retornará STATUS_UNSUCCESSFUL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP, Windows Server 2003 e posterior. |
| Cabeçalho | usbioctl.h (include Usbioctl.h) |