Partager via


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

IRP_MJ_DEVICE_CONTROL

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

USB_NODE_CONNECTION_INFORMATION

USB_NODE_CONNECTION_INFORMATION_EX