IWDFUsbInterface::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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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 einer USB-Schnittstelle zugeordnet ist.
Syntax
WINUSB_INTERFACE_HANDLE GetWinUsbHandle();
Rückgabewert
GetWinUsbHandle- gibt den WinUsb-Schnittstellenziehpunkt zurück, der der USB-Schnittstelle zugeordnet ist.
Bemerkungen
Wenn die Standardschnittstelle aufgerufen wird, gibt die IWDFUsbInterface::GetWinUsbHandle Methode den gleichen WinUsb-Schnittstellenhandle wie IWDFUsbTargetDevice::GetWinUsbHandlezurück. Die Standardschnittstelle wird durch Index 0 identifiziert.
Wenn für Schnittstellen mit Index größer als Null aufgerufen wird, gibt IWDFUsbInterface::GetWinUsbHandle einen anderen Handle als IWDFUsbTargetDevice::GetWinUsbHandlezurück.
Ein UMDF-Treiber kann das WinUsb-Schnittstellenhandle verwenden, um die UMDF-Schnittstellen zu umgehen und WinUSB Routines direkt für schnittstellenbezogene Vorgänge aufzurufen.
Der UMDF-Treiber sollte die WinUsb_Free-Funktion nicht aufrufen, um das WinUsb-Schnittstellenhandle freizugeben, da das USB-Schnittstellenobjekt den Handle besitzt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfusb.h (include Wudfusb.h) |
| DLL- | WUDFx.dll |