Freigeben über


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. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren 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 einer USB-Schnittstelle zugeordnet ist.

Syntax

WINUSB_INTERFACE_HANDLE GetWinUsbHandle();

Rückgabewert

GetWinUsbHandle gibt das WinUsb-Schnittstellenhandle zurück, das der USB-Schnittstelle zugeordnet ist.

Hinweise

Bei Aufruf auf der Standardschnittstelle gibt die IWDFUsbInterface::GetWinUsbHandle-Methode das gleiche WinUsb-Schnittstellenhandle wie IWDFUsbTargetDevice::GetWinUsbHandle zurück. Die Standardschnittstelle wird durch Index null identifiziert.

Wenn für Schnittstellen mit einem Index größer als 0 (null) aufgerufen wird, gibt IWDFUsbInterface::GetWinUsbHandle ein anderes Handle als IWDFUsbTargetDevice::GetWinUsbHandle zurück.

Ein UMDF-Treiber kann das WinUsb-Schnittstellenhandle verwenden, um die UMDF-Schnittstellen zu umgehen und WinUSB-Routinen 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 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 (schließen Sie Wudfusb.h ein)
DLL WUDFx.dll

Weitere Informationen

IWDFUsbInterface

WinUsb_Free

WinUsb_Initialize