IWDFUsbInterface::GetWinUsbHandle method

The GetWinUsbHandle method retrieves the WinUsb interface handle that is associated with a USB interface.

Syntax


WINUSB_INTERFACE_HANDLE GetWinUsbHandle();

Parameters

This method has no parameters.

Return value

GetWinUsbHandle returns the WinUsb interface handle that is associated with the USB interface.

Remarks

If called on the default interface, the IWDFUsbInterface::GetWinUsbHandle method returns the same WinUsb interface handle as IWDFUsbTargetDevice::GetWinUsbHandle. The default interface is identified by index zero.

If called on interfaces with index greater than zero, IWDFUsbInterface::GetWinUsbHandle returns a different handle than IWDFUsbTargetDevice::GetWinUsbHandle.

A UMDF driver can use the WinUsb interface handle to bypass the UMDF interfaces and call WinUSB Routines directly for interface-related operations.

The UMDF driver should not call the WinUsb_Free function to free the WinUsb interface handle because the USB interface object owns the handle.

Requirements