IWDFUsbInterface::SelectSetting method (wudfusb.h)

Article
10/21/2021

[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

Share via