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) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour