Partager via


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

IRP_MJ_DEVICE_CONTROL

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

USB_ROOT_HUB_NAME