ホーム › NetworkManagement.WiFi › WLAN_REALTIME_CONNECTION_QUALITY

WLAN_REALTIME_CONNECTION_QUALITY

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
dot11PhyType	DOT11_PHY_TYPE	4	+0	+0	使用しているPHYタイプ。
ulLinkQuality	DWORD	4	+4	+4	リンク品質を示す値(0〜100)。
ulRxRate	DWORD	4	+8	+8	受信レート(kbps)。
ulTxRate	DWORD	4	+12	+12	送信レート(kbps)。
bIsMLOConnection	BOOL	4	+16	+16	MLO(マルチリンク動作)接続であるかを示す真偽値。
ulNumLinks	DWORD	4	+20	+20	linksInfoに含まれるリンク数。
linksInfo	WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO	272	+24	+24	各リンクのリアルタイム品質情報の配列(可変長の先頭要素)。

各言語での定義

#include <windows.h>

// WLAN_RATE_SET  (x64 256 / x86 256 バイト)
typedef struct WLAN_RATE_SET {
    DWORD uRateSetLength;
    WORD usRateSet[126];
} WLAN_RATE_SET;

// WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO  (x64 272 / x86 272 バイト)
typedef struct WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO {
    BYTE ucLinkID;
    DWORD ulChannelCenterFrequencyMhz;
    DWORD ulBandwidth;
    INT lRssi;
    WLAN_RATE_SET wlanRateSet;
} WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO;

// WLAN_REALTIME_CONNECTION_QUALITY  (x64 296 / x86 296 バイト)
typedef struct WLAN_REALTIME_CONNECTION_QUALITY {
    DOT11_PHY_TYPE dot11PhyType;
    DWORD ulLinkQuality;
    DWORD ulRxRate;
    DWORD ulTxRate;
    BOOL bIsMLOConnection;
    DWORD ulNumLinks;
    WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO linksInfo[1];
} WLAN_REALTIME_CONNECTION_QUALITY;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WLAN_RATE_SET
{
    public uint uRateSetLength;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 126)] public ushort[] usRateSet;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO
{
    public byte ucLinkID;
    public uint ulChannelCenterFrequencyMhz;
    public uint ulBandwidth;
    public int lRssi;
    public WLAN_RATE_SET wlanRateSet;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WLAN_REALTIME_CONNECTION_QUALITY
{
    public int dot11PhyType;
    public uint ulLinkQuality;
    public uint ulRxRate;
    public uint ulTxRate;
    [MarshalAs(UnmanagedType.Bool)] public bool bIsMLOConnection;
    public uint ulNumLinks;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO[] linksInfo;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WLAN_RATE_SET
    Public uRateSetLength As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=126)> Public usRateSet() As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO
    Public ucLinkID As Byte
    Public ulChannelCenterFrequencyMhz As UInteger
    Public ulBandwidth As UInteger
    Public lRssi As Integer
    Public wlanRateSet As WLAN_RATE_SET
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WLAN_REALTIME_CONNECTION_QUALITY
    Public dot11PhyType As Integer
    Public ulLinkQuality As UInteger
    Public ulRxRate As UInteger
    Public ulTxRate As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public bIsMLOConnection As Boolean
    Public ulNumLinks As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public linksInfo() As WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO
End Structure

import ctypes
from ctypes import wintypes

class WLAN_RATE_SET(ctypes.Structure):
    _fields_ = [
        ("uRateSetLength", wintypes.DWORD),
        ("usRateSet", ctypes.c_ushort * 126),
    ]

class WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO(ctypes.Structure):
    _fields_ = [
        ("ucLinkID", ctypes.c_ubyte),
        ("ulChannelCenterFrequencyMhz", wintypes.DWORD),
        ("ulBandwidth", wintypes.DWORD),
        ("lRssi", ctypes.c_int),
        ("wlanRateSet", WLAN_RATE_SET),
    ]

class WLAN_REALTIME_CONNECTION_QUALITY(ctypes.Structure):
    _fields_ = [
        ("dot11PhyType", ctypes.c_int),
        ("ulLinkQuality", wintypes.DWORD),
        ("ulRxRate", wintypes.DWORD),
        ("ulTxRate", wintypes.DWORD),
        ("bIsMLOConnection", wintypes.BOOL),
        ("ulNumLinks", wintypes.DWORD),
        ("linksInfo", WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO * 1),
    ]

#[repr(C)]
pub struct WLAN_RATE_SET {
    pub uRateSetLength: u32,
    pub usRateSet: [u16; 126],
}

#[repr(C)]
pub struct WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO {
    pub ucLinkID: u8,
    pub ulChannelCenterFrequencyMhz: u32,
    pub ulBandwidth: u32,
    pub lRssi: i32,
    pub wlanRateSet: WLAN_RATE_SET,
}

#[repr(C)]
pub struct WLAN_REALTIME_CONNECTION_QUALITY {
    pub dot11PhyType: i32,
    pub ulLinkQuality: u32,
    pub ulRxRate: u32,
    pub ulTxRate: u32,
    pub bIsMLOConnection: i32,
    pub ulNumLinks: u32,
    pub linksInfo: [WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO; 1],
}

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

type WLAN_RATE_SET struct {
	uRateSetLength uint32
	usRateSet [126]uint16
}

type WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO struct {
	ucLinkID byte
	ulChannelCenterFrequencyMhz uint32
	ulBandwidth uint32
	lRssi int32
	wlanRateSet WLAN_RATE_SET
}

type WLAN_REALTIME_CONNECTION_QUALITY struct {
	dot11PhyType int32
	ulLinkQuality uint32
	ulRxRate uint32
	ulTxRate uint32
	bIsMLOConnection int32
	ulNumLinks uint32
	linksInfo [1]WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO
}

type
  WLAN_RATE_SET = record
    uRateSetLength: DWORD;
    usRateSet: array[0..125] of Word;
  end;

  WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO = record
    ucLinkID: Byte;
    ulChannelCenterFrequencyMhz: DWORD;
    ulBandwidth: DWORD;
    lRssi: Integer;
    wlanRateSet: WLAN_RATE_SET;
  end;

  WLAN_REALTIME_CONNECTION_QUALITY = record
    dot11PhyType: Integer;
    ulLinkQuality: DWORD;
    ulRxRate: DWORD;
    ulTxRate: DWORD;
    bIsMLOConnection: BOOL;
    ulNumLinks: DWORD;
    linksInfo: array[0..0] of WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO;
  end;

const WLAN_RATE_SET = extern struct {
    uRateSetLength: u32,
    usRateSet: [126]u16,
};

const WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO = extern struct {
    ucLinkID: u8,
    ulChannelCenterFrequencyMhz: u32,
    ulBandwidth: u32,
    lRssi: i32,
    wlanRateSet: WLAN_RATE_SET,
};

const WLAN_REALTIME_CONNECTION_QUALITY = extern struct {
    dot11PhyType: i32,
    ulLinkQuality: u32,
    ulRxRate: u32,
    ulTxRate: u32,
    bIsMLOConnection: i32,
    ulNumLinks: u32,
    linksInfo: [1]WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO,
};

type
  WLAN_RATE_SET {.bycopy.} = object
    uRateSetLength: uint32
    usRateSet: array[126, uint16]

  WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO {.bycopy.} = object
    ucLinkID: uint8
    ulChannelCenterFrequencyMhz: uint32
    ulBandwidth: uint32
    lRssi: int32
    wlanRateSet: WLAN_RATE_SET

  WLAN_REALTIME_CONNECTION_QUALITY {.bycopy.} = object
    dot11PhyType: int32
    ulLinkQuality: uint32
    ulRxRate: uint32
    ulTxRate: uint32
    bIsMLOConnection: int32
    ulNumLinks: uint32
    linksInfo: array[1, WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO]

struct WLAN_RATE_SET
{
    uint uRateSetLength;
    ushort[126] usRateSet;
}

struct WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO
{
    ubyte ucLinkID;
    uint ulChannelCenterFrequencyMhz;
    uint ulBandwidth;
    int lRssi;
    WLAN_RATE_SET wlanRateSet;
}

struct WLAN_REALTIME_CONNECTION_QUALITY
{
    int dot11PhyType;
    uint ulLinkQuality;
    uint ulRxRate;
    uint ulTxRate;
    int bIsMLOConnection;
    uint ulNumLinks;
    WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO[1] linksInfo;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WLAN_REALTIME_CONNECTION_QUALITY サイズ: 296 バイト(x64)
dim st, 74    ; 4byte整数×74(構造体サイズ 296 / 4 切り上げ)
; dot11PhyType : DOT11_PHY_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ulLinkQuality : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ulRxRate : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ulTxRate : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; bIsMLOConnection : BOOL (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ulNumLinks : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; linksInfo : WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO (+24, 272byte)  varptr(st)+24 を基点に操作(272byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

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

#defstruct global WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO
    #field byte ucLinkID
    #field int ulChannelCenterFrequencyMhz
    #field int ulBandwidth
    #field int lRssi
    #field WLAN_RATE_SET wlanRateSet
#endstruct

#defstruct global WLAN_REALTIME_CONNECTION_QUALITY
    #field int dot11PhyType
    #field int ulLinkQuality
    #field int ulRxRate
    #field int ulTxRate
    #field bool bIsMLOConnection
    #field int ulNumLinks
    #field WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO linksInfo 1
#endstruct

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

WLAN_REALTIME_CONNECTION_QUALITY

フィールド

各言語での定義

HSP用 定義

HSP用定義