DOT11_PHY_ID_LIST 结构 (windot11.h)

  • 项目
重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。
 
DOT11_PHY_ID_LIST 结构指定零个或多个 PHY 类型的列表。

语法

typedef struct DOT11_PHY_ID_LIST {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfEntries;
  ULONG              uTotalNumOfEntries;
  ULONG              dot11PhyId[1];
} DOT11_PHY_ID_LIST, *PDOT11_PHY_ID_LIST;

成员

Header

DOT11_PHY_ID_LIST 结构的类型、修订和大小。 此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将 Header 的成员设置为以下值：

类型

此成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。

修订

此成员必须设置为 DOT11_PHY_ID_LIST_REVISION_1。

大小

此成员必须设置为 sizeof (DOT11_PHY_ID_LIST) 。

有关这些成员的详细信息，请参阅 NDIS_OBJECT_HEADER。

uNumOfEntries

dot11PhyId 数组中的条目数。

uTotalNumOfEntries

dot11PhyId 数组可以包含的最大条目数。

dot11PhyId[1]

PHY 标识符列表 (ID) 。

注解

dot11PhyId 数组中的 PHY ID 必须是下列值之一：

  • 由 Native 802.11 Operational msDot11SupportedPhyTypes 管理信息库定义的受支持 PHY 表中的索引 (MIB) 对象。 有关 PHY ID 和 msDot11SupportedPhyTypes MIB 对象的详细信息，请参阅 OID_DOT11_SUPPORTED_PHY_TYPES。
  • 值为 DOT11_PHY_ID_ANY 的 PHY ID。 此 PHY ID 称为 通配符 PHY ID ，用于指定 802.11 工作站上支持的任何 PHY。 如果使用通配符 PHY ID，则它必须是 dot11PhyId 数组中唯一的条目。
当 OID_DOT11_ACTIVE_PHY_LIST或OID_DOT11_DESIRED_PHY_LIST 查询时，微型端口驱动程序将返回 DOT11_PHY_ID_LIST结构。

查询这些 OID 时，微型端口驱动程序必须验证 MiniportOidRequest 函数的 OidRequest 参数的 InformationBuffer 成员是否足够大，足以返回整个DOT11_PHY_ID_LIST结构，包括 dot11PhyId 数组中的所有条目。 OidRequest 参数的 InformationBufferLength 成员的值确定微型端口驱动程序必须执行的操作，如以下列表所示：

  • 如果 InformationBufferLength 成员的值小于整个DOT11_PHY_ID_LIST结构的长度（以字节为单位），微型端口驱动程序必须执行以下操作：
    • 将 uNumOfEntries 成员设置为零。
    • 将 uTotalNumOfEntries 成员设置为 dot11PhyId 数组中的条目数。
    • 对于 OidRequest 参数，将 BytesWritten 成员设置为零， 将 BytesNeeded 成员设置为整个DOT11_PHY_ID_LIST结构的长度（以字节为单位）。
    • 通过从其 MiniportOidRequest 函数返回NDIS_STATUS_BUFFER_OVERFLOW，使查询请求失败。
  • 如果 InformationBufferLength 成员的值大于或等于整个DOT11_PHY_ID_LIST结构的长度（以字节为单位），微型端口驱动程序必须执行以下操作才能成功完成查询请求：
    • 对于DOT11_PHY_ID_LIST结构，请将 uNumOfEntries 和 uTotalNumOfEntries 成员设置为 dot11PhyId 数组中的条目总数。
    • 对于 OidRequest 参数，将 BytesNeeded 成员设置为零， 将 BytesWritten 成员设置为整个 DOT11_PHY_ID_LIST 结构的长度（以字节为单位）。 微型端口驱动程序还必须将整个 DOT11_PHY_ID_LIST 结构复制到 InformationBuffer 成员。
    • 从其 MiniportOidRequest 函数返回NDIS_STATUS_SUCCESS。

要求

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

另请参阅

OID_DOT11_ACTIVE_PHY_LIST

OID_DOT11_DESIRED_PHY_LIST

NDIS_OBJECT_HEADER