DOT11_BSS_ENTRY 結構 (windot11.h)

重要原生 802.11 無線區域網路介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備磁碟機介面 (WDI) 。 如需 WDI 的詳細資訊,請參閱 WLAN 通用 Windows 驅動程式模型
 
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 的識別碼 (識別碼) ,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

媒體存取控制 (MAC) (位址,適用于在掃描時傳送 802.11 月臺時,802.11 月臺所接收之基礎結構 BSS 網路) 或對等站 (之基礎結構 BS) S 網路) 或對等月臺的存取點) (位址。 這個成員的資料類型是 DOT11_MAC_ADDRESS 結構。

dot11BSSType

BSS 網路類型。

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

lRSSI

接收的訊號強度指標 (RSSI) 值,以 1.0 milliwatts (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 指標或探查回應框架不包含國家/地區資訊元素 (IE) ,請將成員設定為 TRUE

    如需國家/地區 IE 的詳細資訊,請參閱 IEEE 802.11d-2001 標準的第 7.3.2.12 條款。

  • 如果從 AP 或對等站接收的 802.11 指標或探查回應框架會包含 Country IE,如果 Country String 子欄位的值不等於輸入國家/地區字串,請將成員設定為 FALSE
  • 在其他情況下,將成員設定為 TRUE

usBeaconPeriod

802.11 指標或探查回應框架中的 [指標間隔] 欄位值。

ullTimestamp

802.11 指標或探查回應框架中的 Timestamp 欄位值。

ullHostTimestamp

時間戳記是透過 對 NdisGetCurrentSystemTime的呼叫解析,它會記錄 802.11 月臺收到 802.11 指標或探查回應框架的時間。

usCapabilityInformation

802.11 指標或探查回應框架中的 [功能資訊] 欄位值。

uBufferLength

DOT11_BSS_ENTRY 結構中 ucBuffer 陣列的長度,以位元組為單位。 ulBufferLength 必須是 ucBuffer 陣列中資料的確切長度,而且不得包含對齊的任何填補。

ucBuffer[1]

從 802.11 指標或探查回應框架 (IES) 可變長度的資訊元素。 對於每個 BSS,IE 必須來自從該 BSS 網路收到的最後一個指標或探查回應框架。 如果只有一個畫面中提供 IE,迷你埠驅動程式就必須將 IE 與上次收到的指標或探查回應框架中的其他 IE 合併。

當 NIC 位於可延伸存取點 (ExtAP) OP 模式時,BSS 清單應該包含 NIC 所建立之 BSS 的專案。

如需 IEEE 802.11 指標或探查回應框架內欄位的詳細資訊,請參閱 IEEE 802.11-2012 標準中的子句 8.4。

備註

當 802.11 月臺執行掃描工作時,Native 802.11 迷你埠驅動程式會快取收到的 802.11 指標和探查回應畫面。 如需掃描工作的詳細資訊,請參閱 原生 802.11 掃描工作

在 802.11 月臺完成掃描工作之後,迷你埠驅動程式會在 OID_DOT11_ENUM_BSS_LIST查詢時傳回快取的指標和探查回應畫面清單。 個別DOT11_BSS_ENTRY結構會針對每個指標和探查回應框架格式化。

必要條件

   
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
標頭 windot11.h (include Ndis.h)

另請參閱

DOT11_BSS_TYPE

DOT11_BSS_LIST

OID_DOT11_SUPPORTED_PHY_TYPES

OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED

DOT11_MAC_ADDRESS

DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO

NdisGetCurrentSystemTime

OID_DOT11_ENUM_BSS_LIST