IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)

  • Artigo

O IOCTL_USB_GET_NODE_CONNECTION_NAME solicitação de controle de E/S é usado com a estrutura USB_NODE_CONNECTION_NAME para recuperar o nome do link simbólico do hub anexado à porta downstream.

IOCTL_USB_GET_NODE_CONNECTION_NAME é 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 USB_NODE_CONNECTION_NAME . Na entrada, o membro ConnectionIndex dessa estrutura deve indicar o número da porta a ser marcar para um hub anexado.

Comprimento do buffer de entrada

O tamanho de uma estrutura USB_NODE_CONNECTION_NAME .

Buffer de saída

AssociatedIrp.SystemBuffer aponta para uma estrutura USB_NODE_CONNECTION_NAME . Na saída, essa estrutura contém o nome simbólico do hub anexado no membro HubName . Se nenhum hub estiver anexado, o hub não terá um link simbólico ou o dispositivo anexado não for um hub, HubName[0] conterá um valor de UNICODE_NULL.

Comprimento do buffer de saída

O membro Parameters.DeviceIoControl.OutputBufferLength contém o tamanho, em bytes, de toda a estrutura USB_NODE_CONNECTION_NAME .

Bloco de status

A pilha USB define Irp-IoStatus.Status como STATUS_SUCCESS se a solicitação for bem-sucedida>. A solicitação relata êxito, mesmo que nenhum hub esteja anexado, o hub anexado não tenha nenhum link simbólico ou o dispositivo anexado não seja um hub.

Caso contrário, a pilha USB definirá Status como a condição de erro apropriada, como STATUS_INVALID_PARAMETER ou STATUS_INSUFFICIENT_RESOURCES.

Requisitos

Requisito Valor
Cabeçalho usbioctl.h (include Usbioctl.h)

Confira também

USB_NODE_CONNECTION_NAME