IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)
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
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) |