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
Lors de la 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 de début « \xxx\ » 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 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 racine est supprimé ou arrêté, la requête retourne STATUS_SUCCESS mais la chaîne est NULL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | usbioctl.h (include Usbioctl.h) |