fonction USBD_ParseConfigurationDescriptorEx (usbdlib.h)

Article
02/07/2025

La routine USBD_ParseConfigurationDescriptorEx recherche un descripteur de configuration donné et retourne un pointeur vers une interface qui correspond aux critères de recherche donnés.

Syntaxe

PUSB_INTERFACE_DESCRIPTOR USBD_ParseConfigurationDescriptorEx(
  [in] PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  [in] PVOID                         StartPosition,
  [in] LONG                          InterfaceNumber,
  [in] LONG                          AlternateSetting,
  [in] LONG                          InterfaceClass,
  [in] LONG                          InterfaceSubClass,
  [in] LONG                          InterfaceProtocol
);

Paramètres

[in] ConfigurationDescriptor

Pointeur vers un descripteur de configuration USB qui contient l’interface pour laquelle effectuer une recherche.

[in] StartPosition

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

[in] InterfaceNumber

Spécifie l’index défini par l’appareil de l’interface à récupérer. Cela doit être défini sur -1 s’il ne doit pas s’agir d’un critère de recherche.

[in] AlternateSetting

Spécifie l’index de paramètre alternatif défini par l’appareil de l’interface à récupérer. Si l’appelant ne souhaite pas que la valeur de paramètre secondaire soit un critère de recherche, ce paramètre doit être défini sur -1.

[in] InterfaceClass

Spécifie l’identificateur défini par l’appareil ou usb pour la classe d’interface de l’interface à récupérer. Si l’appelant ne souhaite pas que la valeur de la classe d’interface soit un critère de recherche, ce paramètre doit être défini sur -1.

[in] InterfaceSubClass

Spécifie l’identificateur défini par l’appareil ou usb pour la sous-classe d’interface de l’interface à récupérer. Si l’appelant ne souhaite pas que la valeur de sous-classe de l’interface soit un critère de recherche, ce paramètre doit être défini sur -1.

[in] InterfaceProtocol

Spécifie l’identificateur défini par l’appareil ou USB pour le protocole d’interface de l’interface à récupérer. Si l’appelant ne souhaite pas que la valeur du protocole d’interface soit un critère de recherche, ce paramètre doit être défini sur -1.

Valeur de retour

USBD_ParseConfigurationDescriptorEx retourne un pointeur vers le premier descripteur d’interface qui correspond aux critères de recherche donnés. Si aucune interface ne correspond aux critères de recherche, elle retourne NULL.

Remarques

Les appelants peuvent spécifier plusieurs critères de recherche (InterfaceNumber, AlternateSetting, InterfaceClass, InterfaceSubClass et InterfaceProtocol) lors de l’utilisation de cette routine pour rechercher une interface dans un descripteur de configuration. Pour obtenir un exemple de code, consultez USBD_CreateConfigurationRequestEx.

Lorsque cette routine analyse le descripteur de configuration à la recherche du descripteur d’interface qui correspond aux critères de recherche, il retourne la première correspondance, terminant la recherche. Les appelants doivent spécifier autant de critères de recherche que nécessaire pour rechercher l’interface souhaitée.

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

USB_CONFIGURATION_DESCRIPTOR

Partager via