fonction USBD_ParseDescriptors (usbdlib.h)

Article
02/07/2025

La routine USBD_ParseDescriptors recherche un descripteur de configuration donné et retourne un pointeur vers le premier descripteur qui correspond aux critères de recherche.

Syntaxe

PUSB_COMMON_DESCRIPTOR USBD_ParseDescriptors(
  [in] PVOID DescriptorBuffer,
  [in] ULONG TotalLength,
  [in] PVOID StartPosition,
  [in] LONG  DescriptorType
);

Paramètres

[in] DescriptorBuffer

Pointeur vers un descripteur de configuration qui contient le descripteur pour lequel effectuer une recherche.

[in] TotalLength

Spécifie la taille, en octets, de la mémoire tampon pointée par DescriptorBuffer.

[in] StartPosition

Pointeur vers l’adresse dans le descripteur de configuration, fourni à DescriptorBuffer, pour commencer la recherche. Pour effectuer une recherche à partir du début du descripteur de configuration, les paramètres DescriptorBuffer et StartPosition doivent être identiques.

[in] DescriptorType

Spécifie le code de type de descripteur tel qu’il est affecté par USB. Les valeurs suivantes sont valides pour les types de descripteur définis par USB :

USB_STRING_DESCRIPTOR_TYPE

Spécifie que le descripteur recherché est un descripteur de chaîne.

USB_INTERFACE_DESCRIPTOR_TYPE

Spécifie que le descripteur recherché est un descripteur d’interface.

USB_ENDPOINT_DESCRIPTOR_TYPE

Spécifie que le descripteur recherché est un descripteur de point de terminaison.

Valeur de retour

USBD_ParseDescriptors retourne un pointeur vers une structure USB_COMMON_DESCRIPTOR qui est la tête du premier descripteur qui correspond aux critères de recherche donnés, ou NULL est retournée si aucune correspondance n’est trouvée :

Remarques

Cette structure est utilisée pour contenir une partie d’un descripteur, afin que l’appelant de USBD_ParseDescriptors puisse déterminer la structure appropriée à utiliser pour accéder aux données restantes dans le descripteur. Chaque type de descripteur comporte ces champs au début des données et des appelants peuvent utiliser le bLength et membres bDescriptorType pour identifier correctement le type de ce descripteur.

Lorsque cette routine analyse le descripteur de configuration à la recherche du descripteur qui correspond aux critères de recherche, il retourne la première correspondance, terminant la recherche.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	usbdlib.h (include Usbdlib.h)
bibliothèque	Usbd.lib
IRQL	< DISPATCH_LEVEL

Voir aussi

informations de référence sur la programmation du pilote de périphérique USB

Partager via