DOT11_BSS_ENTRY結構（windot11.h）

發行項
02/07/2025

重要

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

DOT11_BSS_ENTRY結構會定義 IEEE 802.11 指標或回應框架，該 802.11 月臺在其上次掃描作業期間收到。

語法

typedef struct DOT11_BSS_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  BOOLEAN                           bInRegDomain;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBufferLength;
  UCHAR                             ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;

成員

uPhyId

PHY 的識別碼（ID）是802.11月臺用來偵測 BSS 網路的標識碼。 PHY 識別碼是驅動程式透過 OID_DOT11_SUPPORTED_PHY_TYPES查詢所傳回支援的 PHY 清單內的索引。

此標識碼不得DOT11_PHY_ID_ANY。

PhySpecificInfo

uPhyId 所參考之 PHY 的屬性 成員。 PhySpecificInfo 格式為 DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO 等位。

dot11BSSID

在掃描時，傳送 802.11 月臺所接收之 802.11 指標或探查回應框架之訪問點（AP）或對等站（適用於基礎結構 BSS 網路）或對等站的媒體存取控制（MAC）位址（適用於基礎結構 BSS 網路）或對等月臺（適用於獨立 BSS 網路）。這個成員的數據類型是 DOT11_MAC_ADDRESS 結構。

dot11BSSType

BSS 網路類型。

這個成員的數據類型是 DOT11_BSS_TYPE 列舉。迷你埠驅動程式不得將此成員設定為 dot11_BSS_type_any 值。

lRSSI

接收的訊號強度指標（RSSI）值，以 1.0 千瓦特（dBm）參考的分貝單位，由 AP 或對等站的 802.11 站所偵測到。

uLinkQuality

從 0 到 100 的連結品質值。值為 100 指定最高的鏈接品質。如需決定連結品質的詳細資訊，請參閱連結質量作業。

bInRegDomain

此成員會指定AP或對等站是否在輸入國家/地區字串所識別的法規網域內運作。若要設定此成員，迷你埠驅動程序必須使用下列指導方針：

如果 802.11 月臺不支援多個法規網域，請將成員設定為 TRUE。如需多個法規網域的詳細資訊，請參閱 OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED。
如果輸入國家/地區字串全部為零，請將成員設定為 true 。
如果 AP 或對等月臺在對輸入國家/ 地區字串所指定的法規網域無效的通道上運作，請將成員設定為 FALSE。
如果從 AP 或對等站接收的 802.11 指標或探查回應框架不包含 Country 資訊元素（IE），請將成員設定為 TRUE。
如需 Country IE 的詳細資訊，請參閱 IEEE 802.11d-2001 標準子句 7.3.2.12。
如果從 AP 或對等站接收的 802.11 指標或探查回應框架包含 Country IE，如果 Country String 子欄位的值不等於輸入國家/地區字串，請將成員設定為 FALSE。
將成員設定為在其他所有情況下 TRUE。