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

Siehe auch

IWDFUsbInterface-

WinUsb_Free

WinUsb_Initialize