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 |