通过

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 频带上启动接入点。

如果设置了 GO on 5 GHz 频带支持，适配器应在播发操作通道上启动 AP，如果失败，它应尝试 AP 频带通道列表参数中指定的列表。 操作系统将通过在 WDI_TLV_P2P_GROUP_OWNER_CAPABILITY 中设置 DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED 标志，向驱动程序提供有关此 AP 是否提供 Internet 连接的提示。

如果指定了 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