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

WLAN_REALTIME_CONNECTION_QUALITY_LINK_INFO

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

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

フィールド

フィールド型サイズx64x86説明
ucLinkIDBYTE1+0+0MLO接続における各リンクの識別子。
ulChannelCenterFrequencyMhzDWORD4+4+4リンクのチャネル中心周波数(MHz)。
ulBandwidthDWORD4+8+8リンクの帯域幅(MHz)。
lRssiINT4+12+12受信信号強度をdBm単位で示す。負の値となる。
wlanRateSetWLAN_RATE_SET256+16+16リンクのレートセット。

各言語での定義

#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;
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;
}
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
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),
    ]
#[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,
}
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_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;
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,
};
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
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;
}

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_LINK_INFO サイズ: 272 バイト(x64)
dim st, 68    ; 4byte整数×68(構造体サイズ 272 / 4 切り上げ)
; ucLinkID : BYTE (+0, 1byte)  poke st,0,値  /  値 = peek(st,0)
; ulChannelCenterFrequencyMhz : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ulBandwidth : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; lRssi : INT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; wlanRateSet : WLAN_RATE_SET (+16, 256byte)  varptr(st)+16 を基点に操作(256byte:入れ子/配列)
; ※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

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