OID_WDI_TASK_START_AP

重要

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

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

Object	支援中止	主機驅動程式原則 (預設優先順序)	正常執行時間 (秒)
連接埠	是的。 中止後面必須加上 dot11 重設。	4	1

在初始化期間，驅動程式會在 WDI_TLV_P2P_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 (s) 。 稍後在指定的通道上重試 () 。

NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE：目前無法在指定的頻 () 上啟動 AP。 請稍後在指定的頻 () 重試。

NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED：由於法規原因，無法在指定的通道上啟動 AP (s) 。

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	已在 Windows 10 1511 版 WDI 1.0.10 版中新增。 要啟動存取點的訊號和通道選擇性清單。 如果 MustUseSpecifiedChannels 設定為 1，則只能從此清單啟動 AP。 如果未設定，此清單就是韌體可以從中挑選的通道建議，如果無法在任何指定的通道上啟動 AP，它可能會挑選另一個通道。

工作完成指示

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

規格需求

最低支援的用戶端	Windows 10
最低支援的伺服器	Windows Server 2016
標頭	Dot11wdi.h