DOT11_BSS_ENTRY構造体 (windot11.h)
大事な
WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。
DOT11_BSS_ENTRY構造体は、最後のスキャン操作中に 802.11 ステーションが受信した IEEE 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
BSS ネットワークの検出に 802.11 ステーションが使用した 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 ネットワークの場合) のメディア アクセス制御 (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
802.11 ステーションが 802.11 ビーコンまたはプローブ応答フレームを受信したときに記録される、NdisGetCurrentSystemTimeの呼び出しによって解決されたタイムスタンプ。
usCapabilityInformation
802.11 ビーコンまたはプローブ応答フレームの機能情報フィールドの値。
uBufferLength
DOT11_BSS_ENTRY構造体の ucBuffer 配列 の長さ (バイト単位)。 ulBufferLength は、ucBuffer 配列内のデータの正確な長さである必要があり、配置用のパディングを含めてはなりません。
ucBuffer[1]
802.11 ビーコンまたはプローブ応答フレームからの可変長情報要素 (IEs)。 各 BSS について、その BSS ネットワークから受信した最後のビーコンまたはプローブ応答フレームからの IP である必要があります。 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 オペレーティング システムで使用できます。 |
ヘッダー | windot11.h (Ndis.h を含む) |
関連項目
OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED DOT11_BSS_ENTRY_PHY_SPECIFIC_INFONdisGetCurrentSystemTime の