IWDFUsbTargetDevice::GetWinUsbHandle-Methode (wudfusb.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]
Die GetWinUsbHandle-Methode ruft das WinUsb-Schnittstellenhandle ab, das einem E/A-Zielgeräteobjekt zugeordnet ist.
Syntax
WINUSB_INTERFACE_HANDLE GetWinUsbHandle();
Rückgabewert
GetWinUsbHandle gibt das WinUsb-Schnittstellenhandle zurück, das dem E/A-Zielgerätobjekt zugeordnet ist.
Hinweise
IWDFUsbTargetDevice::GetWinUsbHandle gibt ein WinUsb-Schnittstellenhandle an die Standardschnittstelle zurück. Die Standardschnittstelle wird durch index null identifiziert.
Ein UMDF-Treiber kann das WinUsb-Schnittstellenhandle verwenden, um die UMDF-Schnittstellen zu umgehen und WinUSB-Routinen für bestimmte Vorgänge direkt aufzurufen.
Der UMDF-Treiber sollte die WinUsb_Free-Funktion nicht aufrufen, um das WinUsb-Schnittstellenhandle freizugeben, da das E/A-Zielgerätobjekt das Handle besitzt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfusb.h (einschließlich Wudfusb.h) |
| DLL | WUDFx.dll |