IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)

  • Artigo

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

IRP_MJ_DEVICE_CONTROL

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)

Confira também

USB_NODE_CONNECTION_ATTRIBUTES