DOT11_BSS_ENTRY 結構 (windot11.h)
語法
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) |