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
802.11 ステーションが BSS ネットワークの検出に使用した PHY の識別子 (ID)。 PHY ID は、OID_DOT11_SUPPORTED_PHY_TYPESのクエリによってドライバーによって返されるサポートされている PHY の一覧内のインデックスです。
この ID をDOT11_PHY_ID_ANYすることはできません。
PhySpecificInfo
uPhyId メンバーによって参照される PHY の属性。 PhySpecificInfo は、 共用体DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO 。
dot11BSSID
スキャン中に 802.11 ステーションによって受信された 802.11 ビーコンまたはプローブ応答フレームを送信したアクセス ポイント (AP) (インフラストラクチャ BSS ネットワークの場合) またはピア ステーション (独立した BSS ネットワークの場合) のメディア アクセス制御 (MAC) アドレス。 このメンバーのデータ型は 、DOT11_MAC_ADDRESS 構造体です。
dot11BSSType
BSS ネットワークの種類。
このメンバーのデータ型は 、DOT11_BSS_TYPE 列挙体です。 ミニポート ドライバーは、このメンバーを dot11_BSS_type_any 値に設定することはできません。
lRSSI
AP またはピア ステーションの 802.11 ステーションによって検出された、1.0 ミリワット (dBm) を参照するデシベル単位の受信信号強度インジケーター (RSSI) 値。
uLinkQuality
0 ~ 100 の範囲のリンク品質の値。 値が 100 の場合、リンクの品質が最も高くなります。 リンク品質の決定の詳細については、「リンク 品質操作」を参照してください。
bInRegDomain
このメンバーは、AP ステーションまたはピア ステーションが、入力国文字列で識別される規制ドメイン内で動作しているかどうかを指定します。 このメンバーを設定するには、ミニポート ドライバーは、次のガイドラインを使用する必要があります。
- 802.11 ステーションで複数の規制ドメインがサポートされていない場合は、メンバーを TRUE に設定 します。 複数の規制ドメインの詳細については、次を参照してください。 OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED。
- 入力国の文字列がすべて 0 の場合は、メンバーを TRUE に設定 します。
- AP またはピア ステーションが、入力国文字列で指定された規制ドメインに対して有効なチャネルで動作していない場合は、メンバーを FALSE に設定 します。
-
AP またはピア ステーションから受信した 802.11 ビーコンまたはプローブ応答フレームに Country information 要素 (IE) が含まれていない場合は、メンバーを TRUE に設定します。
Country 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 ビーコンまたはプローブ応答フレームからの可変長情報要素 (IE)。 BSS ごとに、その BSS ネットワークから受信した最後のビーコンまたはプローブ応答フレームからの IEs である必要があります。 IE が 1 つのフレームでのみ使用可能な場合、ミニポート ドライバーは、最後に受信したビーコンまたはプローブ応答フレームの他の IEs と IE をマージする必要があります。
NIC が拡張アクセス ポイント (ExtAP) OP モードの場合、BSS リストには、NIC によって作成された BSS のエントリが含まれている必要があります。
IEEE 802.11 ビーコンまたはプローブ応答フレーム内のフィールドの詳細については、IEEE 802.11-2012 標準の第 8.4 項を参照してください。
注釈
802.11 ステーションがスキャン操作を実行すると、Native 802.11 ミニポート ドライバーは、受信した 802.11 ビーコンとプローブ応答フレームをキャッシュします。 スキャン操作の詳細については、「 Native 802.11 Scan Operations」を参照してください。
802.11 ステーションがスキャン操作を完了すると、ミニポート ドライバーは、OID_DOT11_ENUM_BSS_LISTによって照会されたときに、キャッシュされたビーコンとプローブ応答フレームの一覧 を返します。 ビーコンとプローブ応答フレームごとに個別のDOT11_BSS_ENTRY構造が書式設定されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| Header | windot11.h (Ndis.h を含む) |