fonction USBD_CreateConfigurationRequestEx (usbdlib.h)

Article
02/07/2025

La routine USBD_CreateConfigurationRequestEx alloue et met en forme un URB pour sélectionner une configuration pour un périphérique USB.

USBD_CreateConfigurationRequestEx remplace USBD_CreateConfigurationRequest.

Syntaxe

PURB USBD_CreateConfigurationRequestEx(
  [in] PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  [in] PUSBD_INTERFACE_LIST_ENTRY    InterfaceList
);

Paramètres

[in] ConfigurationDescriptor

Pointeur vers une structure USB_CONFIGURATION_DESCRIPTOR allouée par l’appelant qui contient le descripteur de configuration à sélectionner. En règle générale, le pilote client envoie un URB du type URB_FUNCTION_GET_DESCRIPTOR_FROM_DEVICE (voir _URB_CONTROL_DESCRIPTOR_REQUEST) pour récupérer des informations sur les configurations, les interfaces, les points de terminaison, le fournisseur et les descripteurs spécifiques à la classe à partir d’un périphérique USB. Lorsque le pilote client spécifie USB_CONFIGURATION_DESCRIPTOR_TYPE comme type de descripteur, la requête récupère toutes les informations d’appareil dans une structure USB_CONFIGURATION_DESCRIPTOR. Le pilote transmet ensuite le pointeur reçu à la structure USB_CONFIGURATION_DESCRIPTOR dans le paramètre ConfigurationDescriptor.

[in] InterfaceList

Pointeur vers le premier élément d’un tableau alloué par l’appelant de structures USBD_INTERFACE_LIST_ENTRY. La longueur du tableau dépend du nombre d’interfaces dans le descripteur de configuration. Le nombre d’éléments dans le tableau doit être un plus que le nombre d’interfaces dans la configuration. Initialisez le tableau en appelant RtlZeroMemory. Le InterfaceDescriptor membre du dernier élément du tableau doit être défini sur NULL.

Valeur de retour

USBD_CreateConfigurationRequestEx alloue une structure URB, la met en forme pour la requête URB_FUNCTION_SELECT_CONFIGURATION (demande de configuration de sélection) et retourne un pointeur vers le URB. Le pilote client peut ensuite utiliser le URB retourné pour envoyer la demande de configuration de sélection au pilote du contrôleur hôte pour définir la configuration. Vous devez libérer le URB lorsque vous avez terminé de l’utiliser.

Remarques

Pour plus d’informations sur la création d’une demande de configuration de sélection et d’un exemple de code, consultez Comment sélectionner une configuration pour un périphérique USB.

La valeur retournée est un pointeur vers la structure URB que vous pouvez utiliser pour envoyer une demande de configuration de sélection au pilote du contrôleur hôte pour définir la configuration spécifiée.

Une fois la pile de pilotes USB terminée la demande de configuration de sélection, vous pouvez inspecter les structures USBD_INTERFACE_INFORMATION. Le Pipes membre de USBD_INTERFACE_INFORMATION pointe vers un tableau de structures USBD_PIPE_INFORMATION. Le pilote de bus USB remplit le tableau de structures USBD_PIPE_INFORMATION avec des informations sur les canaux associés aux points de terminaison de l’interface. Le pilote client peut obtenir des handles de canal à partir du Pipes[i].PipeHandle et les utiliser pour envoyer des demandes d’E/S à des canaux spécifiques.

Une fois que vous avez terminé toutes les opérations avec le URBretourné, vous devez libérer le URB en appelant ExFreePool.

Vous pouvez allouer le descripteur de configuration et le tableau à partir d’un pool non paginé ou paginé. Les appelants de cette routine peuvent s’exécuter sur IRQL <= DISPATCH_LEVEL si la mémoire pointée par ConfigurationDescriptor et InterfaceList est allouée à partir du pool non paginé. Sinon, les appelants doivent s’exécuter au < DISPATCH_LEVEL IRQL.