windot11.h) (DOT11_PHY_TYPE_INFO 结构

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

DOT11_PHY_TYPE_INFO 结构定义 802.11 工作站在执行显式扫描操作时用于配置 PHY 的参数。 工作站在 OID_DOT11_SCAN_REQUEST的一组请求后执行显式扫描操作。

语法

typedef struct _DOT11_PHY_TYPE_INFO {
  union {
    DOT11_PHY_TYPE dot11PhyType;
    ULONG          uPhyId;
  };
  BOOLEAN             bUseParameters;
  ULONG               uProbeDelay;
  ULONG               uMinChannelTime;
  ULONG               uMaxChannelTime;
  CH_DESCRIPTION_TYPE ChDescriptionType;
  ULONG               uChannelListSize;
  UCHAR               ucChannelListBuffer[1];
} DOT11_PHY_TYPE_INFO, *PDOT11_PHY_TYPE_INFO;

成员

dot11PhyType

802.11 工作站将用于扫描的 PHY 类型。 PHY 类型由 DOT11_PHY_TYPE 枚举定义。

注意 如果微型端口驱动程序在 Extensible Station (ExtSTA) 模式下运行，则必须忽略此成员。

bUseParameters

如果此成员为 TRUE，则 802.11 工作站使用此结构的其他成员来配置扫描操作的 PHY。

如果此成员为 FALSE，则 802.11 工作站使用自己的扫描操作设置配置 PHY。

注意 如果微型端口驱动程序在 ExtSTA 模式下运行，操作系统将始终将此成员设置为 FALSE。

uProbeDelay

802.11 工作站在主动扫描期间传输 802.11 探测请求帧之前必须等待的时间量（以微秒为单位）。

uMinChannelTime

802.11 工作站在扫描时在每个通道上花费的最小时间量（以 802.11 时间单位 (TU) ）。 一个 TU 为 1024 微秒。

此成员必须大于或等于 uProbeDelay 。

uMaxChannelTime

扫描时，802.11 工作站在每个通道上花费的最长时间（以 802.11 时间单位为单位） (TU) 。

此成员必须大于或等于 uProbeDelay 。

ChDescriptionType

此成员指定用于解释 ucChannelListBuffer 数组中的条目的方法。 此成员的数据类型是声明以下值的 CH_DESCRIPTION_TYPE 枚举：

ch_description_type_logical

通道条目由逻辑通道编号定义，以符合 IEEE 802.11 标准。

ch_description_type_center_frequency

通道入口由通道中心频率定义，单位为兆赫 (MHz) 。

uChannelListSize

ucChannelListBuffer 数组的长度（以字节为单位）。 此数组中的每个条目的格式设置为 ULONG 数据类型。

ucChannelListBuffer[1]

一个数组，其中包含 dot11PhyType 成员中指定的 PHY 类型的通道说明。

注解

DOT11_SCAN_REQUEST_V2 结构（附带OID_DOT11_SCAN_REQUEST的一组请求）包含零个或多个DOT11_PHY_TYPE_INFO条目的数组。

有关 Native 802.11 微型端口驱动程序执行的扫描操作的详细信息，请参阅 本机 802.11 扫描操作。

有关 ExtSTA 操作模式的详细信息，请参阅 可扩展工作站操作模式。

要求

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
标头	windot11.h (包括 Ndis.h)

另请参阅

DOT11_SCAN_REQUEST_V2

OID_DOT11_SCAN_REQUEST