共用方式為


IWDFUsbInterface::SelectSetting 方法 (wudfusb.h)

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

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

語法

HRESULT SelectSetting(
  [in] UCHAR SettingNumber
);

參數

[in] SettingNumber

在USB介面上選取的設定。

傳回值

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

傳回碼 Description
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