IWDFUsbInterface::GetWinUsbHandle 方法 (wudfusb.h)

[警告: UMDF 2 是最新版本的 UMDF,并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能,并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅使用 UMDF 入门。]

GetWinUsbHandle 方法检索与 USB 接口关联的 WinUsb 接口句柄。

语法

WINUSB_INTERFACE_HANDLE GetWinUsbHandle();

返回值

GetWinUsbHandle 返回与 USB 接口关联的 WinUsb 接口句柄。

注解

如果在默认接口上调用, IWDFUsbInterface::GetWinUsbHandle 方法将返回与 IWDFUsbTargetDevice::GetWinUsbHandle 相同的 WinUsb 接口句柄。 默认接口由索引零标识。

如果在索引大于零的接口上调用, IWDFUsbInterface::GetWinUsbHandle 将返回与 IWDFUsbTargetDevice::GetWinUsbHandle 不同的句柄。

UMDF 驱动程序可以使用 WinUsb 接口句柄绕过 UMDF 接口,并直接调用 WinUSB 例程 进行接口相关操作。

UMDF 驱动程序不应调用 WinUsb_Free 函数来释放 WinUsb 接口句柄,因为 USB 接口对象拥有该句柄。

要求

要求
结束支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.5
标头 wudfusb.h (包括 Wudfusb.h)
DLL WUDFx.dll

另请参阅

IWDFUsbInterface

WinUsb_Free

WinUsb_Initialize