共用方式為


IWDFUsbInterface::SelectSetting 方法 (wudfusb.h)

[警告: UMDF 2 是最新版本的 UMDF,並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1,而且較新版本的 Windows 10 上對 UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱 開始使用 UMDF。]

SelectSetting 方法會選取 USB 介面上的指定替代設定。

語法

HRESULT SelectSetting(
  [in] UCHAR SettingNumber
);

參數

[in] SettingNumber

在USB介面上選取的設定。

傳回值

SelectSetting 會傳回下列其中一個值:

傳回碼 描述
S_OK

SelectSetting 已成功選取指定 SettingNumber 參數的設定。

E_OUTOFMEMORY

SelectSetting 發生配置失敗。

Winerror.h 中定義的錯誤碼
此值對應於 WinUsb API 傳回的錯誤碼。

言論

架構會自動選取組態零、其介面為零,以及替代設定零。 若要變更替代設定,驅動程式可以呼叫 SelectSetting

如需詳細資訊,USB 組態描述元

例子


hr = pIWDFUsbInterface->SelectSetting(SettingNumber);

要求

要求 價值
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平臺 桌面
最低 UMDF 版本 1.5
標頭 wudfusb.h (包括 Wudfusb.h)
DLL WUDFx.dll

另請參閱

IWDFUsbInterface