IOCTL_USB_USER_REQUEST IOCTL (usbuser.h)

Article
03/06/2024

La demande de contrôle d’E /S IOCTL_USB_USER_REQUEST est disponible pour les applications en mode utilisateur et les pilotes en mode noyau.

IOCTL_USB_USER_REQUEST 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).

Les appelants peuvent spécifier l’un des codes de requête suivants :

USBUSER_CLEAR_ROOTPORT_FEATURE: N’utilisez pas cette demande.
USBUSER_GET_CONTROLLER_DRIVER_KEY: Signale la clé de pilote du contrôleur hôte dans une chaîne Unicode de type USB_UNICODE_NAME. Cette demande est toujours activée.
USBUSER_GET_CONTROLLER_INFO_0: Récupère une structure USB_CONTROLLER_INFO_0 qui décrit le contrôleur hôte. Cette demande est toujours activée.
USBUSER_GET_ROOTPORT_STATUS: N’utilisez pas cette demande.
USBUSER_GET_ROOTHUB_SYMBOLIC_NAME: Signale le nom symbolique du hub racine dans une chaîne Unicode de type USB_UNICODE_NAME. Cette demande est toujours activée.
USBUSER_INVALID_REQUEST: N’utilisez pas cette demande.
USBUSER_OP_CLOSE_RAW_DEVICE: N’utilisez pas cette demande.
USBUSER_OP_OPEN_RAW_DEVICE: N’utilisez pas cette demande.
USBUSER_OP_MASK_DEVONLY_API: N’utilisez pas cette demande.
USBUSER_OP_MASK_HCTEST_API: N’utilisez pas cette demande.
USBUSER_OP_RAW_RESET_PORT: N’utilisez pas cette demande.
USBUSER_OP_SEND_ONE_PACKET: N’utilisez pas cette demande.
USBUSER_OP_SEND_RAW_COMMAND: N’utilisez pas cette demande.
USBUSER_SET_ROOTPORT_FEATURE: N’utilisez pas cette demande.
USBUSER_PASS_THRU: Envoie une commande spécifique au fournisseur définie par la structure USB_PASS_THRU_PARAMETERS au pilote miniport du contrôleur hôte. Cette demande est toujours activée.
USBUSER_GET_BANDWIDTH_INFORMATION: Récupère une structure USB_BANDWIDTH_INFO qui contient des informations sur la bande passante allouée. Cette demande est toujours activée.
USBUSER_GET_POWER_STATE_MAP: Récupère une structure USB_POWER_INFO qui contient des informations sur l’état d’alimentation du contrôleur hôte et des hubs racines. Cette demande est toujours activée.
USBUSER_GET_BUS_STATISTICS_0: Récupère une structure USB_BUS_STATISTICS_0 qui contient des statistiques de bus. Cette demande est toujours activée.
USBUSER_GET_BUS_STATISTICS_0_AND_RESET: N’utilisez pas cette demande.
USBUSER_GET_USB_DRIVER_INFORMATION: Récupère une structure USB_DRIVER_VERSION_PARAMETERS qui indique la version du pilote, de la pile USB et des interfaces associées. Cette demande est toujours activée.
USBUSER_GET_USB2_HW_VERSION: N’utilisez pas cette demande.

Mémoire tampon d'entrée

La mémoire tampon dans Irp-AssociatedIrp.SystemBuffer> contient une structure d’en-tête de requête utilisateur (USBUSER_REQUEST_HEADER) qui définit la requête. Suivant la structure d’en-tête se trouve une structure qui contient les paramètres de la demande. Pour plus d’informations sur les structures de paramètres qui correspondent à chaque requête, consultez la description de chaque requête.

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

Taille d’une structure USBUSER_REQUEST_HEADER .

Mémoire tampon de sortie

Une structure de paramètre suit immédiatement la structure USBUSER_REQUEST_HEADER sur Irp-AssociatedIrp.SystemBuffer>. Pour certaines demandes utilisateur, la structure de paramètres contient des données de sortie une fois la demande terminée.