Partager via


IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)

La demande de contrôle d’E /S IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES récupère les attributs de port étendus par Microsoft pour un port spécifique.

IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES 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_ATTRIBUTES allouée par l’utilisateur. Lors de l’entrée, l’appelant spécifie le numéro de port dans le membre ConnectionIndex d’une structure USB_NODE_CONNECTION_ATTRIBUTES .

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

Taille d’une structure USB_NODE_CONNECTION_ATTRIBUTES .

Mémoire tampon de sortie

Lors de la sortie, la structure USB_NODE_CONNECTION_ATTRIBUTES dans AssociatedIrp.SystemBuffer décrit les attributs de port étendus par Microsoft pour le port. Note Pour Windows Vista, Windows Server 2008 et Windows 7, le champ Attributs de port étendus par Microsoft est défini sur zéro.

Pour Windows XP et Windows Server 2003, l’attribut de port étendu Microsoft peut être défini sur USB_PORTATTR_NO_OVERCURRENT_UI. Cette valeur indique que l’interface utilisateur est masquée lorsqu’une surintensité se produit sur le port.

Longueur de la mémoire tampon de sortie

Parameters.DeviceIoControl.OutputBufferLength indique la taille, en octets, des données retournées dans SystemBuffer.

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. Si le hub n’a pas été démarré ou n’est pas fonctionnel, la requête retourne STATUS_UNSUCCESSFUL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP, Windows Server 2003 et versions ultérieures.
En-tête usbioctl.h (include Usbioctl.h)

Voir aussi

USB_NODE_CONNECTION_ATTRIBUTES