IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)
La demande IOCTL_USB_GET_NODE_CONNECTION_INFORMATION récupère des informations sur le port USB indiqué et l’appareil attaché au port, le cas échéant.
Les pilotes clients doivent envoyer ce IOCTL à un IRQL de PASSIVE_LEVEL.
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 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 de USB_NODE_CONNECTION_INFORMATION allouée par l’utilisateur qui décrit la connexion. En entrée, le membre ConnectionIndex de cette structure contient le numéro de port.
Longueur de la mémoire tampon d’entrée
Taille d’une structure USB_NODE_CONNECTION_INFORMATION .
Mémoire tampon de sortie
Sur la sortie, le membre Parameters.DeviceIoControl.OutputBufferLength contient la taille des données de sortie. Cette taille est variable, car elle dépend du nombre de canaux associés au port.
AssociatedIrp.SystemBuffer pointe vers une structure de USB_NODE_CONNECTION_INFORMATION allouée par l’utilisateur qui contient les données de sortie.
Longueur de la mémoire tampon de sortie
Taille d’une structure USB_NODE_CONNECTION_INFORMATION .
Bloc d’état
La pile USB définit Irp-IoStatus.Status> sur STATUS_SUCCESS si la demande réussit. Sinon, la pile USB définit Status sur la condition d’erreur appropriée, telle que STATUS_INVALID_PARAMETER ou STATUS_INSUFFICIENT_RESOURCES.
Remarques
La requête IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX est une version étendue de IOCTL_USB_GET_NODE_CONNECTION_INFORMATION. Les deux requêtes sont identiques, sauf que la version étendue de la demande peut signaler des connexions à faible, complet et à haut débit, et que l’ancienne IOCTL_USB_GET_NODE_CONNECTION_INFORMATION demande signale uniquement les connexions à faible et plein débit. Pour plus d’informations sur la différence entre ces deux demandes, consultez USB_NODE_CONNECTION_INFORMATION et USB_NODE_CONNECTION_INFORMATION_EX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | usbioctl.h (inclure Usbioctl.h) |
Voir aussi
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX