Edit

IWDFUsbInterface::SelectSetting method (wudfusb.h)

  • Article

[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 SelectSetting method selects the specified alternate setting on a USB interface.

Syntax

HRESULT SelectSetting(
  [in] UCHAR SettingNumber
);

Parameters

[in] SettingNumber

The setting to select on the USB interface.

Return value

SelectSetting returns one of the following values:

Return code Description
S_OK

SelectSetting successfully selected the setting that the SettingNumber parameter specified.
E_OUTOFMEMORY

SelectSetting encountered an allocation failure.
An error code that is defined in Winerror.h
 This value corresponds to the error code that the WinUsb API returned.

Remarks

The framework automatically selects configuration zero, its interface zero, and the alternate setting zero. To change the alternate setting, the driver can call SelectSetting.

For more info USB Configuration Descriptors

Examples


hr = pIWDFUsbInterface->SelectSetting(SettingNumber);

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

IWDFUsbInterface