WdfUsbInterfaceGetDescriptor, fonction (wdfusb.h)

Article
02/27/2024

[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 de USB_INTERFACE_DESCRIPTOR allouée par l’appelant que l’infrastructure remplit.

Valeur de retour

None

Remarques

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

Un bogue case activée 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 de remplacement pour une interface USB spécifiée. Ensuite, l’exemple obtient le descripteur d’interface USB qui représente l’autre paramètre actuel de l’interface USB.

BYTE  settingIndex;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;

settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(
                             UsbInterface
                             );

WdfUsbInterfaceGetDescriptor(
                             UsbInterface,
                             settingIndex,
                             &interfaceDescriptor
                             );

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	wdfusb.h (inclure 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