IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)

  • Article

La demande de contrôle d’E /S IOCTL_USB_GET_NODE_CONNECTION_NAME est utilisée avec la structure USB_NODE_CONNECTION_NAME pour récupérer le nom de lien symbolique du hub attaché au port en aval.

IOCTL_USB_GET_NODE_CONNECTION_NAME est une demande de contrôle d’E/S en mode utilisateur. Cette requête cible le périphérique hub USB (GUID_DEVINTERFACE_USB_HUB).

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Le membre AssociatedIrp.SystemBuffer pointe vers une structure USB_NODE_CONNECTION_NAME . Lors de l’entrée, le membre ConnectionIndex de cette structure doit indiquer le numéro du port à case activée pour un hub attaché.

Longueur de la mémoire tampon d’entrée

Taille d’une structure USB_NODE_CONNECTION_NAME .

Mémoire tampon de sortie

AssociatedIrp.SystemBuffer pointe vers une structure USB_NODE_CONNECTION_NAME . Sur la sortie, cette structure contient le nom symbolique du hub attaché dans le membre HubName . Si aucun hub n’est attaché, que le hub n’a pas de lien symbolique ou que l’appareil attaché n’est pas un hub, HubName[0] contient une valeur de UNICODE_NULL.

Longueur de la mémoire tampon de sortie

Le membre Parameters.DeviceIoControl.OutputBufferLength contient la taille, en octets, de la structure USB_NODE_CONNECTION_NAME entière.

Bloc d’état

La pile USB définit Irp-IoStatus.Status> sur STATUS_SUCCESS si la demande réussit. La demande signale la réussite, même si aucun hub n’est attaché, si le hub attaché n’a aucun lien symbolique ou si l’appareil attaché n’est pas un hub.

Sinon, la pile USB définit Status sur la condition d’erreur appropriée, telle que STATUS_INVALID_PARAMETER ou STATUS_INSUFFICIENT_RESOURCES.

Configuration requise

Condition requise Valeur
En-tête usbioctl.h (include Usbioctl.h)

Voir aussi

USB_NODE_CONNECTION_NAME