ホーム › NetworkManagement.WiFi › DOT11_ASSOCIATION_INFO_LIST

DOT11_ASSOCIATION_INFO_LIST

構造体

サイズx64: 344 バイト / x86: 344 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
Header	NDIS_OBJECT_HEADER	4	+0	+0	NDIS オブジェクトのバージョン情報を含むヘッダー。
uNumOfEntries	DWORD	4	+4	+4	dot11AssocInfo に実際に格納された要素数を表す。
uTotalNumOfEntries	DWORD	4	+8	+8	格納可能なアソシエーション情報の最大個数を表す。
dot11AssocInfo	DOT11_ASSOCIATION_INFO_EX	328	+16	+16	アソシエーション情報を列挙する配列。可変長。

各言語での定義

#include <windows.h>

// NDIS_OBJECT_HEADER  (x64 4 / x86 4 バイト)
typedef struct NDIS_OBJECT_HEADER {
    BYTE Type;
    BYTE Revision;
    WORD Size;
} NDIS_OBJECT_HEADER;

// 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;

// DOT11_ASSOCIATION_INFO_LIST  (x64 344 / x86 344 バイト)
typedef struct DOT11_ASSOCIATION_INFO_LIST {
    NDIS_OBJECT_HEADER Header;
    DWORD uNumOfEntries;
    DWORD uTotalNumOfEntries;
    DOT11_ASSOCIATION_INFO_EX dot11AssocInfo[1];
} DOT11_ASSOCIATION_INFO_LIST;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NDIS_OBJECT_HEADER
{
    public byte Type;
    public byte Revision;
    public ushort Size;
}

[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;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DOT11_ASSOCIATION_INFO_LIST
{
    public NDIS_OBJECT_HEADER Header;
    public uint uNumOfEntries;
    public uint uTotalNumOfEntries;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public DOT11_ASSOCIATION_INFO_EX[] dot11AssocInfo;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NDIS_OBJECT_HEADER
    Public Type As Byte
    Public Revision As Byte
    Public Size As UShort
End Structure

<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

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DOT11_ASSOCIATION_INFO_LIST
    Public Header As NDIS_OBJECT_HEADER
    Public uNumOfEntries As UInteger
    Public uTotalNumOfEntries As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public dot11AssocInfo() As DOT11_ASSOCIATION_INFO_EX
End Structure

import ctypes
from ctypes import wintypes

class NDIS_OBJECT_HEADER(ctypes.Structure):
    _fields_ = [
        ("Type", ctypes.c_ubyte),
        ("Revision", ctypes.c_ubyte),
        ("Size", ctypes.c_ushort),
    ]

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),
    ]

class DOT11_ASSOCIATION_INFO_LIST(ctypes.Structure):
    _fields_ = [
        ("Header", NDIS_OBJECT_HEADER),
        ("uNumOfEntries", wintypes.DWORD),
        ("uTotalNumOfEntries", wintypes.DWORD),
        ("dot11AssocInfo", DOT11_ASSOCIATION_INFO_EX * 1),
    ]

#[repr(C)]
pub struct NDIS_OBJECT_HEADER {
    pub Type: u8,
    pub Revision: u8,
    pub Size: u16,
}

#[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,
}

#[repr(C)]
pub struct DOT11_ASSOCIATION_INFO_LIST {
    pub Header: NDIS_OBJECT_HEADER,
    pub uNumOfEntries: u32,
    pub uTotalNumOfEntries: u32,
    pub dot11AssocInfo: [DOT11_ASSOCIATION_INFO_EX; 1],
}

import "golang.org/x/sys/windows"

type NDIS_OBJECT_HEADER struct {
	Type byte
	Revision byte
	Size uint16
}

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_LIST struct {
	Header NDIS_OBJECT_HEADER
	uNumOfEntries uint32
	uTotalNumOfEntries uint32
	dot11AssocInfo [1]DOT11_ASSOCIATION_INFO_EX
}

type
  NDIS_OBJECT_HEADER = record
    Type: Byte;
    Revision: Byte;
    Size: Word;
  end;

  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;

  DOT11_ASSOCIATION_INFO_LIST = record
    Header: NDIS_OBJECT_HEADER;
    uNumOfEntries: DWORD;
    uTotalNumOfEntries: DWORD;
    dot11AssocInfo: array[0..0] of DOT11_ASSOCIATION_INFO_EX;
  end;

const NDIS_OBJECT_HEADER = extern struct {
    Type: u8,
    Revision: u8,
    Size: u16,
};

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,
};

const DOT11_ASSOCIATION_INFO_LIST = extern struct {
    Header: NDIS_OBJECT_HEADER,
    uNumOfEntries: u32,
    uTotalNumOfEntries: u32,
    dot11AssocInfo: [1]DOT11_ASSOCIATION_INFO_EX,
};

type
  NDIS_OBJECT_HEADER {.bycopy.} = object
    Type: uint8
    Revision: uint8
    Size: uint16

  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

  DOT11_ASSOCIATION_INFO_LIST {.bycopy.} = object
    Header: NDIS_OBJECT_HEADER
    uNumOfEntries: uint32
    uTotalNumOfEntries: uint32
    dot11AssocInfo: array[1, DOT11_ASSOCIATION_INFO_EX]

struct NDIS_OBJECT_HEADER
{
    ubyte Type;
    ubyte Revision;
    ushort Size;
}

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;
}

struct DOT11_ASSOCIATION_INFO_LIST
{
    NDIS_OBJECT_HEADER Header;
    uint uNumOfEntries;
    uint uTotalNumOfEntries;
    DOT11_ASSOCIATION_INFO_EX[1] dot11AssocInfo;
}

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_LIST サイズ: 344 バイト(x64)
dim st, 86    ; 4byte整数×86(構造体サイズ 344 / 4 切り上げ)
; Header : NDIS_OBJECT_HEADER (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; uNumOfEntries : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; uTotalNumOfEntries : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dot11AssocInfo : DOT11_ASSOCIATION_INFO_EX (+16, 328byte)  varptr(st)+16 を基点に操作(328byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global NDIS_OBJECT_HEADER
    #field byte Type
    #field byte Revision
    #field short Size
#endstruct

#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

#defstruct global DOT11_ASSOCIATION_INFO_LIST
    #field NDIS_OBJECT_HEADER Header
    #field int uNumOfEntries
    #field int uTotalNumOfEntries
    #field DOT11_ASSOCIATION_INFO_EX dot11AssocInfo 1
#endstruct

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

DOT11_ASSOCIATION_INFO_LIST

フィールド

各言語での定義

HSP用 定義

HSP用定義