WdfUsbTargetDeviceGetInterface, fonction (wdfusb.h)
[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) |