IWDFUsbTargetDevice::GetWinUsbHandle method (wudfusb.h)
[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]
The GetWinUsbHandle method retrieves the WinUsb interface handle that is associated with an I/O target device object.
Syntax
WINUSB_INTERFACE_HANDLE GetWinUsbHandle();
Return value
GetWinUsbHandle returns the WinUsb interface handle that is associated with the I/O target device object.
Remarks
IWDFUsbTargetDevice::GetWinUsbHandle returns a WinUsb interface handle to the default interface. The default interface is identified by index zero.
A UMDF driver can use the WinUsb interface handle to bypass the UMDF interfaces and call WinUSB Routines directly for certain operations.
The UMDF driver should not call the WinUsb_Free function to free the WinUsb interface handle because the I/O target device object owns the handle.
Requirements
| Requirement | Value |
|---|---|
| End of support | Unavailable in UMDF 2.0 and later. |
| Target Platform | Desktop |
| Minimum UMDF version | 1.5 |
| Header | wudfusb.h (include Wudfusb.h) |
| DLL | WUDFx.dll |