IOCTL_USB_GET_HUB_CAPABILITIES_EX IOCTL (usbioctl.h)

  • Artigo

A solicitação de controle de E/S IOCTL_USB_GET_HUB_CAPABILITIES_EX recupera os recursos de um hub USB.

IOCTL_USB_GET_HUB_CAPABILITIES_EX é 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 um buffer alocado pelo usuário.

Comprimento do buffer de entrada

O comprimento do buffer é igual a sizeof(USB_HUB_CAPABILITIES_EX).

Buffer de saída

AssociatedIrp.SystemBuffer aponta para uma estrutura de USB_HUB_CAPABILITIES_EX alocada pelo usuário. Na saída, essa estrutura descreve os recursos do hub.

Comprimento do buffer de saída

O membro Parameters.DeviceIoControl.OutputBufferLength indica o tamanho, em bytes, dos dados retornados em SystemBuffer ou sizeof(USB_HUB_CAPABILITIES_EX).

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. 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 Vista e posteriores.
Cabeçalho usbioctl.h (inclua Usbioctl.h)

Confira também

USB_HUB_CAPABILITIES_EX