共用方式為


OID_WDI_TASK_START_AP (dot11wificxintf.h)

重要

本主題是 WiFiCx驅動程式模型的一部分。 WiFiCx 是 Windows 11 中發行 Wi-Fi 驅動程式模型。 我們建議您使用WiFiCx來利用最新的功能。 先前 Wi-Fi 驅動程式模型 WDI 處於維護模式,而且只會收到高優先順序修正。

OID_WDI_TASK_START_AP要求 IHV 元件設定埠,以在指定的埠上啟動 Wi-Fi 直接群組擁有者。

物件 支援中止 預設優先權 (主機驅動程式原則) 一般執行時間(秒)
港口 是的。 中止必須接著 dot11 重設。 4 1

在初始化期間,驅動程式會在 WIFI_WIFIDIRECT_CAPABILITIES 中設定 GO on 5GHz 頻帶功能,以指出是否可以在 5 GHz 頻帶上啟動存取點。

如果已設定 5 GHz 頻帶支援的 GO,配接器應該在公告的作業通道上啟動 AP,如果失敗,它應該嘗試 AP 頻帶清單清單參數中指定的清單。 作系統會透過在 WDI_TLV_P2P_GROUP_OWNER_CAPABILITY中設定 DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED 旗標,向驅動程式提供此 AP 是否提供因特網連線的提示。

如果 指定了 WDI_TLV_START_AP_PARAMETERS 中的 MustUseSpecifiedChannel,如果 AP 無法在指定的頻/通道上啟動 AP,可能會傳回下列其中一個錯誤:

  • NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE:目前無法在指定的通道上啟動AP。 稍後在指定的通道上重試。

  • NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE:目前無法在指定的頻帶上啟動AP。 稍後在指定的頻帶上重試。

  • NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED:由於法規原因,無法在指定的通道上啟動AP。

  • NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED:由於法規原因,無法在指定的頻帶上啟動AP。

工作參數

TLV 允許多個 TLV 實例 自選 描述
WDI_TLV_SSID AP 要使用的 SSID。
WDI_TLV_START_AP_PARAMETERS 此工作的其他參數。
WDI_TLV_AUTH_ALGO_LIST 連接可以使用的驗證演算法清單。
WDI_TLV_MULTICAST_CIPHER_ALGO_LIST 連接可以使用的多播加密演算法清單。
WDI_TLV_UNICAST_CIPHER_ALGO_LIST 連接可以使用的多播加密演算法清單。
WDI_TLV_P2P_CHANNEL_NUMBER X 如果指定,這會定義在群組形成中決定的作業通道。 只有當作業模式 Wi-Fi Direct GO 時,才能指定此專案。
WDI_TLV_AP_BAND_CHANNEL X X 選擇性的頻帶和通道清單,以啟動存取點。 如果 MustUseSpecifiedChannels 設定為 1,則只能從此列表啟動 AP。 如果未設定,此清單就是韌體可以從中挑選的通道建議,如果無法在任何指定的通道上啟動AP,它可能會挑選另一個通道。

任務完成指示

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

要求

要求 價值
最低支援的用戶端 Windows 11
最低支援的伺服器 Windows Server 2022
頁眉 dot11wificxintf.h