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直接群組擁有者。
| Object | 支援中止 | 主機驅動程式原則 (預設優先順序) | 正常執行時間 (秒) |
|---|---|---|---|
| 連接埠 | 是的。 中止後面必須加上 dot11 重設。 | 4 | 1 |
在初始化期間，驅動程式會在 WIFI_WIFIDIRECT_CAPABILITIES 中設定 GO on 5GHz 帶功能，以指出是否可以在 5 GHz 帶上啟動存取點。
如果已設定 GO on 5 GHz 頻外支援，配接器應該在公告的作業通道上啟動 AP，如果失敗，它應該嘗試 AP 頻頻通道清單參數中指定的清單。 作業系統會透過在 WDI_TLV_P2P_GROUP_OWNER_CAPABILITY中設定DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED旗標，為驅動程式提供有關此 AP 是否提供網際網路連線的提示。
如果指定了WDI_TLV_START_AP_PARAMETERS中的MustUseSpecifiedChannel，如果 AP 無法在指定的訊號/通道上啟動 AP，則 AP 可能會傳回下列其中一個錯誤， (s) ：
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 | API 要使用的 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 |