IOCTL_GET_USB_DESCRIPTOR IOCTL (usbscan.h)

Retourne un descripteur USB spécifié.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Pointeur vers une structure USBSCAN_GET_DESCRIPTOR .

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

Taille de la mémoire tampon d’entrée.

Mémoire tampon de sortie

Pointeur vers une structure USB_DEVICE_DESCRIPTOR, USB_STRING_DESCRIPTOR ou USB_CONFIGURATION_DESCRIPTOR .

Longueur de la mémoire tampon de sortie

Taille de la mémoire tampon de sortie.

Bloc d’état

Irp->IoStatus.Status est défini sur STATUS_SUCCESS si la demande réussit. Sinon, indiquez la condition d’erreur appropriée en tant que code NTSTATUS .

Remarques

Paramètres DeviceIoControl

Lorsque la fonction DeviceloControl est appelée avec le code de contrôle d’E/S IOCTL_GET_USB_DESCRIPTOR, l’appelant doit spécifier l’adresse d’une structure de USBSCAN_GET_DESCRIPTOR comme paramètre lpInBuffer de la fonction. En fonction de la valeur spécifiée pour le membre DescriptorType de la structure USBSCAN_GET_DESCRIPTOR, le paramètre lpOutbuffer de la fonction doit pointer vers une structure USB_DEVICE_DESCRIPTOR, USB_STRING_DESCRIPTOR ou USB_CONFIGURATION_DESCRIPTOR .

Le pilote en mode noyau obtient un descripteur USB en appelant UsbBuildGetDescriptorRequest.

Pour plus d’informations, consultez Accès aux pilotes Kernel-Mode pour les appareils à image fixe.

Pour plus d’informations sur les descripteurs USB, consultez la Spécification du bus série universel.

Configuration requise