WdfUsbTargetDeviceGetInterface, fonction (wdfusb.h)

  • Article

[S’applique à KMDF et UMDF]

La méthode WdfUsbTargetDeviceGetInterface retourne un handle à l’objet d’interface USB du framework associé à un index d’interface spécifié.

Syntaxe

WDFUSBINTERFACE WdfUsbTargetDeviceGetInterface(
  [in] WDFUSBDEVICE UsbDevice,
  [in] UCHAR        InterfaceIndex
);

Paramètres

[in] UsbDevice

Handle pour un objet de périphérique USB obtenu à partir d’un appel précédent à WdfUsbTargetDeviceCreateWithParameters.

[in] InterfaceIndex

Valeur d’index de base zéro qui spécifie un objet d’interface USB dans la configuration actuelle. Cette valeur d’index peut ne pas être identique au numéro d’interface défini par la spécification USB.

Valeur retournée

WdfUsbTargetDeviceGetInterface retourne un handle à un objet d’interface USB. Si la valeur InterfaceIndex n’est pas valide, cette méthode retourne NULL.

Un bogue case activée se produit si un handle d’objet fourni par le pilote n’est pas valide.

Remarques

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

Exemples

L’exemple de code suivant obtient un handle pour le premier objet d’interface USB que l’infrastructure a créé pour un périphérique USB. L’exemple obtient ensuite le nombre de points de terminaison associés à l’objet d’interface.

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

UsbInterface = WdfUsbTargetDeviceGetInterface(
                                              deviceContext->UsbTargetDevice,
                                              0
                                              );
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

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

WdfUsbTargetDeviceCreateWithParameters