IWDFUsbTargetDevice ::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é à un objet d’appareil cible d’E/S.
Syntaxe
WINUSB_INTERFACE_HANDLE GetWinUsbHandle();
Valeur de retour
GetWinUsbHandle retourne le handle d’interface WinUsb associé à l’objet d’appareil cible d’E/S.
Remarques
IWDFUsbTargetDevice ::GetWinUsbHandle retourne un handle d’interface WinUsb à l’interface par défaut. L’interface par défaut est identifiée par l’index zéro.
Un pilote UMDF peut utiliser le handle d’interface WinUsb pour contourner les interfaces UMDF et appeler routines WinUSB directement pour certaines opérations.
Le pilote UMDF ne doit pas appeler la fonction WinUsb_Free pour libérer le handle d’interface WinUsb, car l’objet d’appareil cible d’E/S 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 |