Share via


LPSET_INTERFACE (Compact 2013)

3/26/2014

This function sends a SET_INTERFACE request to a universal serial bus (USB) device to change the device's settings.

Syntax

typedef USB_TRANSFER (* LPSET_INTERFACE)(
  USB_HANDLE hDevice,
  LPTRANSFER_NOTIFY_ROUTINE lpStartAddress,
  LPVOID lpvNotifyParameter,
  DWORD dwFlags,
  UCHAR bInterfaceNumber,
  UCHAR bAlternateSetting
);

Parameters

  • hDevice
    [in] Handle to a USB device.
  • lpStartAddress
    [in] Pointer to the address of a callback routine of type LPTRANSFER_NOTIFY_ROUTINE, which should be NULL unless the USB_NO_WAIT flag is set.
  • lpvNotifyParameter
    [in] Pointer to the parameter to pass to the callback routine.
  • dwFlags
    [in] Value of USB_NO_WAIT or zero (0).
  • bInterfaceNumber
    [in] Interface number being changed on the device.
  • bAlternateSetting
    [in] Number of the alternate.

Return Value

A USB_TRANSFER handle indicates success. NULL indicates failure.

Remarks

This function initiates a control transfer to a USB device specifying the alternate setting to use for the specified interface.

Requirements

Header

usbdi.h

See Also

Reference

USB Driver Functions
LPABORT_TRANSFER
LPGET_INTERFACE
LPGET_TRANSFER_STATUS
LPIS_TRANSFER_COMPLETE
LPTRANSFER_NOTIFY_ROUTINE