DOT11_BSS_ENTRY構造 (windot11.h)

[アーティクル]
08/08/2023

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

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

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 を含む)