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 |