Méthode IWDFUsbInterface ::GetWinUsbHandle (wudfusb.h)
[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]
La méthode GetWinUsbHandle récupère le handle d’interface WinUsb associé à une interface USB.
Syntaxe
WINUSB_INTERFACE_HANDLE GetWinUsbHandle();
Valeur de retour
GetWinUsbHandle retourne le handle d’interface WinUsb associé à l’interface USB.
Remarques
Si elle est appelée sur l’interface par défaut, la méthode IWDFUsbInterface ::GetWinUsbHandle retourne le même handle d’interface WinUsb que IWDFUsbTargetDevice ::GetWinUsbHandle. L’interface par défaut est identifiée par l’index zéro.
Si elle est appelée sur les interfaces dont l’index est supérieur à zéro, IWDFUsbInterface ::GetWinUsbHandle retourne un handle différent de IWDFUsbTargetDevice ::GetWinUsbHandle.
Un pilote UMDF peut utiliser le handle d’interface WinUsb pour contourner les interfaces UMDF et appeler des routines WinUSB directement pour les opérations liées à l’interface.
Le pilote UMDF ne doit pas appeler la fonction WinUsb_Free pour libérer le handle d’interface WinUsb, car l’objet d’interface USB est propriétaire du handle.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge | Non disponible dans UMDF 2.0 et versions ultérieures. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| Version UMDF minimale | 1.5 |
| En-tête | wudfusb.h (inclure Wudfusb.h) |
| DLL | WUDFx.dll |