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

See also

IWDFUsbTargetDevice

WinUsb_Free

WinUsb_Initialize