DOT11_PEER_INFO構造 (windot11.h)

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

 

DOT11_PEER_INFO構造体は、独立した基本サービス セット (IBSS) ネットワーク内のピア ステーションに関する情報を指定します。

メモ IBSS (アドホック) と SoftAP は非推奨です。 Windows 8.1 および Windows Server 2012 R2 以降では、Wi-Fi Directを使用します。

 

構文

typedef struct _DOT11_PEER_INFO {
  DOT11_MAC_ADDRESS       MacAddress;
  USHORT                  usCapabilityInformation;
  DOT11_AUTH_ALGORITHM    AuthAlgo;
  DOT11_CIPHER_ALGORITHM  UnicastCipherAlgo;
  DOT11_CIPHER_ALGORITHM  MulticastCipherAlgo;
  BOOLEAN                 bWpsEnabled;
  USHORT                  usListenInterval;
  UCHAR                   ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2];
  USHORT                  usAssociationID;
  DOT11_ASSOCIATION_STATE AssociationState;
  DOT11_POWER_MODE        PowerMode;
  LARGE_INTEGER           liAssociationUpTime;
  DOT11_PEER_STATISTICS   Statistics;
} DOT11_PEER_INFO, *PDOT11_PEER_INFO;

メンバー

MacAddress

独立した BSS (IBSS) ネットワーク内のピア ステーションのメディア アクセス制御 (MAC) アドレス。

usCapabilityInformation

802.11 ステーションがピアから最後に受信したビーコンまたはプローブ応答フレームの 802.11 機能情報フィールド。

AuthAlgo

関連付け操作中に 802.11 ステーションがピア ステーションと解決した認証アルゴリズム。 AuthAlgo メンバーのデータ型の詳細については、「DOT11_AUTH_ALGORITHM」を参照してください。

ピアが関連付けられていない場合、このメンバーは定義されません。

UnicastCipherAlgo

関連付け操作中に 802.11 ステーションがピア ステーションと解決したユニキャスト暗号アルゴリズム。 ユニキャストCipherAlgo メンバーのデータ型の詳細については、「DOT11_CIPHER_ALGORITHM」を参照してください。

ピアが関連付けられていない場合、このメンバーは定義されません。

MulticastCipherAlgo

関連付け操作中に 802.11 ステーションがピア ステーションと解決したマルチキャスト暗号アルゴリズム。 MulticastCipherAlgo メンバーのデータ型の詳細については、「DOT11_CIPHER_ALGORITHM」を参照してください。

ピアが関連付けられていない場合、このメンバーは定義されません。

bWpsEnabled

ピア ステーションに対して WiFi Protected Setup (WPS) が有効になっているかどうかを示すブール値。 TRUE の場合、WPS が有効になり、ピアによって使用される認証アルゴリズムと暗号アルゴリズムが、AP で有効になっているアルゴリズムとは異なる場合があります。

ピアが関連付けられていない場合は、このメンバーを使用しないでください。

usListenInterval

関連付け要求から取得された 802.11 Listen Interval フィールドを定義する USHORT 値。

ピアが関連付けられていない場合、このメンバーの値は 0 になります。

ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2]

ピア ステーションでサポートされるデータ レートを指定する UCHAR 値。 これらのレートは、802.11 ステーションがピアから最後に受信したビーコンまたはプローブ応答フレームからの 802.11 サポートレート IE に基づいています。

ucPeerSupportedRates 配列の各エントリは、 のクエリによって返されるデータ レートのテーブル内のインデックスの値です。 OID_DOT11_DATA_RATE_MAPPING_TABLE。 インデックス値は 2 から 127 の間である必要があります。

ピアが関連付けられていない場合、このメンバーの値は 0 になります。

usAssociationID

802.11 ステーションが AP から受信した関連付けまたは再関連付け応答フレームの 802.11 関連付け ID フィールドを指定する USHORT 値。

ピアが関連付けられていない場合、このメンバーの値は 0xFFFF になります。

AssociationState

ピア ステーションの 802.11 認証と関連付けの状態を示すDOT11_ASSOCIATION_STATE型の値。 状態は 、dot11_assoc_state_auth_unassoc または dot11_assoc_state_auth_assocにすることができます。

IEEE 802.11 Standard では、独立したネットワークでは 802.11 認証手順は省略可能です。 したがって、IHV の実装によっては、 dot11_assoc_state_auth_unassoc 列挙値で表される状態は適用できない場合があります。

PowerMode

ピア ステーションの最新の電源管理モードを記述する DOT11_POWER_MODE型の値。

liAssociationUpTime

802.11 関連付けプロシージャが正常に完了したときのタイムスタンプを指定する LARGEINTEGER 値。 ミニポート ドライバーは、関連付けの完了のタイムスタンプを取得する NdisGetCurrentSystemTime を呼び出します。

ピアが関連付けられていない場合、このメンバーの値は 0 になります。

Statistics

DOT11_PEER_STATISTICS構造によって定義されるデータ トラフィックの統計カウンター。

ピアが関連付けられていない場合、このメンバーの値は 0 になります。

要件

要件	値
サポートされている最小のクライアント	Windows 7 以降のバージョンの Windows オペレーティング システムで使用できます。
Header	windot11.h (Ndis.h を含む)

こちらもご覧ください

DOT11_POWER_MODE

DOT11_ASSOCIATION_STATE

NdisGetCurrentSystemTime

DOT11_PEER_STATISTICS

DOT11_PEER_INFO_LIST

NDIS_OBJECT_HEADER