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

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.5

Header

Wudfusb.h (include Wudfusb.h)

DLL

WUDFx.dll

See also

IWDFUsbInterface
WinUsb_Free
WinUsb_Initialize

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft