UsbBuildSelectInterfaceRequest macro

The UsbBuildSelectInterfaceRequest macro formats an URB with the parameters necessary to select an alternate setting for an interface on a USB device.

Syntax

void UsbBuildSelectInterfaceRequest(
  [in] PURB                      Urb,
  [in] USHORT                    Length,
  [in] USBD_CONFIGURATION_HANDLE ConfigurationHandle,
  [in] UCHAR                     InterfaceNumber,
  [in] UCHAR                     AlternateSetting
);

Parameters

• Urb [in]
  Pointer to an URB that is to be formatted as a select-interface request.

• Length [in]
  Specifies the size, in bytes, of the URB. The URB_FUNCTION_SELECT_INTERFACE URB has a variable length. Clients can use the GET_SELECT_INTERFACE_REQUEST_SIZE macro to determine the URB length.

• ConfigurationHandle [in]
  Specifies the handle for this interface returned by the HCD when a configuration was selected.

• InterfaceNumber [in]
  Is the device-defined identifier for this interface specified in the descriptor for this interface.

• AlternateSetting [in]
  Is the device-defined identifier of the alternate setting that this interface should now use.

Return value

This macro does not return a value.

Requirements

See also

URB

_URB_SELECT_INTERFACE

USB device driver programming reference

Send comments about this topic to Microsoft