WdfUsbInterfaceGetDescriptor, fonction (wdfusb.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

La méthode WdfUsbInterfaceGetDescriptor récupère le descripteur d’interface USB associé à un autre paramètre spécifié d’une interface USB spécifiée.

Syntaxe

void WdfUsbInterfaceGetDescriptor(
  [in]  WDFUSBINTERFACE           UsbInterface,
  [in]  UCHAR                     SettingIndex,
  [out] PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor
);

Paramètres

[in] UsbInterface

Handle vers un objet d’interface USB obtenu en appelant WdfUsbTargetDeviceGetInterface.

[in] SettingIndex

Valeur d’index qui identifie un autre paramètre pour l’interface. Pour plus d’informations sur les autres paramètres, consultez la spécification USB.

[out] InterfaceDescriptor

Pointeur vers une structure USB_INTERFACE_DESCRIPTOR allouée par l’appelant que l’infrastructure remplit.

Valeur de retour

Aucun

Remarques

Si la valeur SettingIndex n’est pas valide, la structure USB_INTERFACE_DESCRIPTOR peut recevoir des données non valides.

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Pour plus d’informations sur la méthode WdfUsbInterfaceGetDescriptor et les cibles d’E/S USB, consultez cibles d’E/S USB.

Exemples

L’exemple de code suivant obtient l’index de paramètre secondaire pour une interface USB spécifiée. Ensuite, l’exemple obtient le descripteur d’interface USB qui représente le paramètre alternatif actuel de l’interface USB.

BYTE  settingIndex;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;

settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(
                             UsbInterface
                             );

WdfUsbInterfaceGetDescriptor(
                             UsbInterface,
                             settingIndex,
                             &interfaceDescriptor
                             );

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdfusb.h (include Wdfusb.h)
bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Voir aussi

USB_INTERFACE_DESCRIPTOR

WdfUsbTargetDeviceGetInterface

Partager via