Share via


Méthode IWDFUsbTargetDevice ::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é à 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 des 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 de périphérique cible d’E/S 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

Voir aussi

IWDFUsbTargetDevice

WinUsb_Free

WinUsb_Initialize