Win32 API 日本語リファレンス
ホーム › NetworkManagement.WiFi › DOT11_ASSOCIATION_INFO_EX

DOT11_ASSOCIATION_INFO_EX

構造体
サイズx64: 328 バイト / x86: 328 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
PeerMacAddressBYTE6+0+0アソシエートしているピアの MAC アドレス。
BSSIDBYTE6+6+6接続先 BSS の BSSID。
usCapabilityInformationWORD2+12+12ピアの能力情報フィールドを表す。
usListenIntervalWORD2+14+14ピアのリッスンインターバルを表す。
ucPeerSupportedRatesBYTE255+16+16ピアが対応するデータレートの配列。
usAssociationIDWORD2+272+272割り当てられたアソシエーション識別子(AID)。
dot11AssociationStateDOT11_ASSOCIATION_STATE4+276+276アソシエーションの状態を示す列挙値。
dot11PowerModeDOT11_POWER_MODE4+280+280ピアの電源管理モードを示す列挙値。
liAssociationUpTimeLONGLONG8+288+288アソシエーション継続時間を表す。
ullNumOfTxPacketSuccessesULONGLONG8+296+296ピアへの送信成功パケット数を表す。
ullNumOfTxPacketFailuresULONGLONG8+304+304ピアへの送信失敗パケット数を表す。
ullNumOfRxPacketSuccessesULONGLONG8+312+312ピアからの受信成功パケット数を表す。
ullNumOfRxPacketFailuresULONGLONG8+320+320ピアからの受信失敗パケット数を表す。

各言語での定義

#include <windows.h>

// DOT11_ASSOCIATION_INFO_EX  (x64 328 / x86 328 バイト)
typedef struct DOT11_ASSOCIATION_INFO_EX {
    BYTE PeerMacAddress[6];
    BYTE BSSID[6];
    WORD usCapabilityInformation;
    WORD usListenInterval;
    BYTE ucPeerSupportedRates[255];
    WORD usAssociationID;
    DOT11_ASSOCIATION_STATE dot11AssociationState;
    DOT11_POWER_MODE dot11PowerMode;
    LONGLONG liAssociationUpTime;
    ULONGLONG ullNumOfTxPacketSuccesses;
    ULONGLONG ullNumOfTxPacketFailures;
    ULONGLONG ullNumOfRxPacketSuccesses;
    ULONGLONG ullNumOfRxPacketFailures;
} DOT11_ASSOCIATION_INFO_EX;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DOT11_ASSOCIATION_INFO_EX
{
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 6)] public byte[] PeerMacAddress;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 6)] public byte[] BSSID;
    public ushort usCapabilityInformation;
    public ushort usListenInterval;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 255)] public byte[] ucPeerSupportedRates;
    public ushort usAssociationID;
    public int dot11AssociationState;
    public int dot11PowerMode;
    public long liAssociationUpTime;
    public ulong ullNumOfTxPacketSuccesses;
    public ulong ullNumOfTxPacketFailures;
    public ulong ullNumOfRxPacketSuccesses;
    public ulong ullNumOfRxPacketFailures;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DOT11_ASSOCIATION_INFO_EX
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=6)> Public PeerMacAddress() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=6)> Public BSSID() As Byte
    Public usCapabilityInformation As UShort
    Public usListenInterval As UShort
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=255)> Public ucPeerSupportedRates() As Byte
    Public usAssociationID As UShort
    Public dot11AssociationState As Integer
    Public dot11PowerMode As Integer
    Public liAssociationUpTime As Long
    Public ullNumOfTxPacketSuccesses As ULong
    Public ullNumOfTxPacketFailures As ULong
    Public ullNumOfRxPacketSuccesses As ULong
    Public ullNumOfRxPacketFailures As ULong
End Structure
import ctypes
from ctypes import wintypes

class DOT11_ASSOCIATION_INFO_EX(ctypes.Structure):
    _fields_ = [
        ("PeerMacAddress", ctypes.c_ubyte * 6),
        ("BSSID", ctypes.c_ubyte * 6),
        ("usCapabilityInformation", ctypes.c_ushort),
        ("usListenInterval", ctypes.c_ushort),
        ("ucPeerSupportedRates", ctypes.c_ubyte * 255),
        ("usAssociationID", ctypes.c_ushort),
        ("dot11AssociationState", ctypes.c_int),
        ("dot11PowerMode", ctypes.c_int),
        ("liAssociationUpTime", ctypes.c_longlong),
        ("ullNumOfTxPacketSuccesses", ctypes.c_ulonglong),
        ("ullNumOfTxPacketFailures", ctypes.c_ulonglong),
        ("ullNumOfRxPacketSuccesses", ctypes.c_ulonglong),
        ("ullNumOfRxPacketFailures", ctypes.c_ulonglong),
    ]
#[repr(C)]
pub struct DOT11_ASSOCIATION_INFO_EX {
    pub PeerMacAddress: [u8; 6],
    pub BSSID: [u8; 6],
    pub usCapabilityInformation: u16,
    pub usListenInterval: u16,
    pub ucPeerSupportedRates: [u8; 255],
    pub usAssociationID: u16,
    pub dot11AssociationState: i32,
    pub dot11PowerMode: i32,
    pub liAssociationUpTime: i64,
    pub ullNumOfTxPacketSuccesses: u64,
    pub ullNumOfTxPacketFailures: u64,
    pub ullNumOfRxPacketSuccesses: u64,
    pub ullNumOfRxPacketFailures: u64,
}
import "golang.org/x/sys/windows"

type DOT11_ASSOCIATION_INFO_EX struct {
	PeerMacAddress [6]byte
	BSSID [6]byte
	usCapabilityInformation uint16
	usListenInterval uint16
	ucPeerSupportedRates [255]byte
	usAssociationID uint16
	dot11AssociationState int32
	dot11PowerMode int32
	liAssociationUpTime int64
	ullNumOfTxPacketSuccesses uint64
	ullNumOfTxPacketFailures uint64
	ullNumOfRxPacketSuccesses uint64
	ullNumOfRxPacketFailures uint64
}
type
  DOT11_ASSOCIATION_INFO_EX = record
    PeerMacAddress: array[0..5] of Byte;
    BSSID: array[0..5] of Byte;
    usCapabilityInformation: Word;
    usListenInterval: Word;
    ucPeerSupportedRates: array[0..254] of Byte;
    usAssociationID: Word;
    dot11AssociationState: Integer;
    dot11PowerMode: Integer;
    liAssociationUpTime: Int64;
    ullNumOfTxPacketSuccesses: UInt64;
    ullNumOfTxPacketFailures: UInt64;
    ullNumOfRxPacketSuccesses: UInt64;
    ullNumOfRxPacketFailures: UInt64;
  end;
const DOT11_ASSOCIATION_INFO_EX = extern struct {
    PeerMacAddress: [6]u8,
    BSSID: [6]u8,
    usCapabilityInformation: u16,
    usListenInterval: u16,
    ucPeerSupportedRates: [255]u8,
    usAssociationID: u16,
    dot11AssociationState: i32,
    dot11PowerMode: i32,
    liAssociationUpTime: i64,
    ullNumOfTxPacketSuccesses: u64,
    ullNumOfTxPacketFailures: u64,
    ullNumOfRxPacketSuccesses: u64,
    ullNumOfRxPacketFailures: u64,
};
type
  DOT11_ASSOCIATION_INFO_EX {.bycopy.} = object
    PeerMacAddress: array[6, uint8]
    BSSID: array[6, uint8]
    usCapabilityInformation: uint16
    usListenInterval: uint16
    ucPeerSupportedRates: array[255, uint8]
    usAssociationID: uint16
    dot11AssociationState: int32
    dot11PowerMode: int32
    liAssociationUpTime: int64
    ullNumOfTxPacketSuccesses: uint64
    ullNumOfTxPacketFailures: uint64
    ullNumOfRxPacketSuccesses: uint64
    ullNumOfRxPacketFailures: uint64
struct DOT11_ASSOCIATION_INFO_EX
{
    ubyte[6] PeerMacAddress;
    ubyte[6] BSSID;
    ushort usCapabilityInformation;
    ushort usListenInterval;
    ubyte[255] ucPeerSupportedRates;
    ushort usAssociationID;
    int dot11AssociationState;
    int dot11PowerMode;
    long liAssociationUpTime;
    ulong ullNumOfTxPacketSuccesses;
    ulong ullNumOfTxPacketFailures;
    ulong ullNumOfRxPacketSuccesses;
    ulong ullNumOfRxPacketFailures;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DOT11_ASSOCIATION_INFO_EX サイズ: 328 バイト(x64)
dim st, 82    ; 4byte整数×82(構造体サイズ 328 / 4 切り上げ)
; PeerMacAddress : BYTE (+0, 6byte)  varptr(st)+0 を基点に操作(6byte:入れ子/配列)
; BSSID : BYTE (+6, 6byte)  varptr(st)+6 を基点に操作(6byte:入れ子/配列)
; usCapabilityInformation : WORD (+12, 2byte)  wpoke st,12,値  /  値 = wpeek(st,12)
; usListenInterval : WORD (+14, 2byte)  wpoke st,14,値  /  値 = wpeek(st,14)
; ucPeerSupportedRates : BYTE (+16, 255byte)  varptr(st)+16 を基点に操作(255byte:入れ子/配列)
; usAssociationID : WORD (+272, 2byte)  wpoke st,272,値  /  値 = wpeek(st,272)
; dot11AssociationState : DOT11_ASSOCIATION_STATE (+276, 4byte)  st.69 = 値  /  値 = st.69   (lpoke/lpeek も可)
; dot11PowerMode : DOT11_POWER_MODE (+280, 4byte)  st.70 = 値  /  値 = st.70   (lpoke/lpeek も可)
; liAssociationUpTime : LONGLONG (+288, 8byte)  qpoke st,288,値 / qpeek(st,288)  ※IronHSPのみ。3.7/3.8は lpoke st,288,下位 : lpoke st,292,上位
; ullNumOfTxPacketSuccesses : ULONGLONG (+296, 8byte)  qpoke st,296,値 / qpeek(st,296)  ※IronHSPのみ。3.7/3.8は lpoke st,296,下位 : lpoke st,300,上位
; ullNumOfTxPacketFailures : ULONGLONG (+304, 8byte)  qpoke st,304,値 / qpeek(st,304)  ※IronHSPのみ。3.7/3.8は lpoke st,304,下位 : lpoke st,308,上位
; ullNumOfRxPacketSuccesses : ULONGLONG (+312, 8byte)  qpoke st,312,値 / qpeek(st,312)  ※IronHSPのみ。3.7/3.8は lpoke st,312,下位 : lpoke st,316,上位
; ullNumOfRxPacketFailures : ULONGLONG (+320, 8byte)  qpoke st,320,値 / qpeek(st,320)  ※IronHSPのみ。3.7/3.8は lpoke st,320,下位 : lpoke st,324,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DOT11_ASSOCIATION_INFO_EX
    #field byte PeerMacAddress 6
    #field byte BSSID 6
    #field short usCapabilityInformation
    #field short usListenInterval
    #field byte ucPeerSupportedRates 255
    #field short usAssociationID
    #field int dot11AssociationState
    #field int dot11PowerMode
    #field int64 liAssociationUpTime
    #field int64 ullNumOfTxPacketSuccesses
    #field int64 ullNumOfTxPacketFailures
    #field int64 ullNumOfRxPacketSuccesses
    #field int64 ullNumOfRxPacketFailures
#endstruct

stdim st, DOT11_ASSOCIATION_INFO_EX        ; NSTRUCT 変数を確保
st->usCapabilityInformation = 100
mes "usCapabilityInformation=" + st->usCapabilityInformation