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é.
WDFUSBINTERFACE WdfUsbTargetDeviceGetInterface(
[in] WDFUSBDEVICE UsbDevice,
[in] UCHAR InterfaceIndex
);
[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.
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.
Pour plus d’informations sur la méthode WdfUsbTargetDeviceGetInterface et les cibles d’E/S USB, consultez Cibles d’E/S USB.
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
);
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) |