IWDFUsbInterface ::GetWinUsbHandle, méthode (wudfusb.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer 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 des interfaces avec un index 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 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 possède le handle.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfusb.h (include Wudfusb.h) |
| DLL | WUDFx.dll |