IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)
La demande de contrôle d’E/S IOCTL_USB_GET_ROOT_HUB_NAME est utilisée avec la structure USB_ROOT_HUB_NAME pour récupérer le nom de lien symbolique du hub racine.
IOCTL_USB_GET_ROOT_HUB_NAME est une demande de contrôle d’E/S en mode utilisateur. Cette requête cible le contrôleur hôte USB (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).
Code principal
Mémoire tampon d’entrée
Aucun.
Longueur de la mémoire tampon d’entrée
Aucun.
Mémoire tampon de sortie
En sortie, le membre AssociatedIrp.SystemBuffer pointe vers une structure USB_ROOT_HUB_NAME qui contient le nom de lien symbolique du hub racine. Le texte « \xxx\ » de début n’est pas inclus dans la chaîne récupérée.
Longueur de la mémoire tampon de sortie
Taille d’une structure USB_ROOT_HUB_NAME.
Bloc d’état
La pile USB définit Irp->IoStatus.Status sur STATUS_SUCCESS si la requête réussit. Sinon, la pile USB définit 'état à la condition d’erreur appropriée, telle que STATUS_INVALID_PARAMETER ou STATUS_INSUFFICIENT_RESOURCES.
Si le hub racine est supprimé ou arrêté, la requête retourne STATUS_SUCCESS, mais la chaîne a la valeur NULL.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | usbioctl.h (include Usbioctl.h) |