Metodo IWDFUsbInterface::GetWinUsbHandle (wudfusb.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]
Il metodo GetWinUsbHandle recupera l'handle dell'interfaccia WinUsb associato a un'interfaccia USB.
Sintassi
WINUSB_INTERFACE_HANDLE GetWinUsbHandle();
Valore restituito
GetWinUsbHandle restituisce l'handle dell'interfaccia WinUsb associato all'interfaccia USB.
Commenti
Se viene chiamato nell'interfaccia predefinita, il metodo IWDFUsbInterface::GetWinUsbHandle restituisce lo stesso handle di interfaccia WinUsb come IWDFUsbTargetDevice::GetWinUsbHandle. L'interfaccia predefinita è identificata da indice zero.
Se viene chiamato su interfacce con indice maggiore di zero, IWDFUsbInterface::GetWinUsbHandle restituisce un handle diverso da IWDFUsbTargetDevice::GetWinUsbHandle.
Un driver UMDF può usare l'handle dell'interfaccia WinUsb per ignorare le interfacce UMDF e chiamare routine WinUSB direttamente per le operazioni correlate all'interfaccia.
Il driver UMDF non deve chiamare la funzione WinUsb_Free per liberare l'handle dell'interfaccia WinUsb perché l'oggetto interfaccia USB possiede l'handle.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.5 |
| Intestazione | wudfusb.h (include Wudfusb.h) |
| DLL | WUDFx.dll |