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

MIB_IPPATH_TABLE

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

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

フィールド

フィールドサイズx64x86説明
NumEntriesDWORD4+0+0Table配列に格納されたパスエントリの数を示す。
TableMIB_IPPATH_ROW152/136+8+8IPパス行(MIB_IPPATH_ROW)の可変長配列である。

各言語での定義

#include <windows.h>

// IN_ADDR  (x64 8 / x86 4 バイト)
typedef struct IN_ADDR {
    _S_un_e__Union S_un;
} IN_ADDR;

// SOCKADDR_IN  (x64 24 / x86 16 バイト)
typedef struct SOCKADDR_IN {
    ADDRESS_FAMILY sin_family;
    WORD sin_port;
    IN_ADDR sin_addr;
    CHAR sin_zero[8];
} SOCKADDR_IN;

// IN6_ADDR  (x64 16 / x86 16 バイト)
typedef struct IN6_ADDR {
    _u_e__Union u;
} IN6_ADDR;

// SOCKADDR_IN6  (x64 32 / x86 28 バイト)
typedef struct SOCKADDR_IN6 {
    ADDRESS_FAMILY sin6_family;
    WORD sin6_port;
    DWORD sin6_flowinfo;
    IN6_ADDR sin6_addr;
    _Anonymous_e__Union Anonymous;
} SOCKADDR_IN6;

// SOCKADDR_INET  (x64 32 / x86 28 バイト)
typedef struct SOCKADDR_INET {
    SOCKADDR_IN Ipv4;
    SOCKADDR_IN6 Ipv6;
    ADDRESS_FAMILY si_family;
} SOCKADDR_INET;

// NET_LUID_LH  (x64 8 / x86 8 バイト)
typedef struct NET_LUID_LH {
    ULONGLONG Value;
    _Info_e__Struct Info;
} NET_LUID_LH;

// MIB_IPPATH_ROW  (x64 152 / x86 136 バイト)
typedef struct MIB_IPPATH_ROW {
    SOCKADDR_INET Source;
    SOCKADDR_INET Destination;
    NET_LUID_LH InterfaceLuid;
    DWORD InterfaceIndex;
    SOCKADDR_INET CurrentNextHop;
    DWORD PathMtu;
    DWORD RttMean;
    DWORD RttDeviation;
    _Anonymous_e__Union Anonymous;
    BOOLEAN IsReachable;
    ULONGLONG LinkTransmitSpeed;
    ULONGLONG LinkReceiveSpeed;
} MIB_IPPATH_ROW;

// MIB_IPPATH_TABLE  (x64 160 / x86 144 バイト)
typedef struct MIB_IPPATH_TABLE {
    DWORD NumEntries;
    MIB_IPPATH_ROW Table[1];
} MIB_IPPATH_TABLE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IN_ADDR
{
    public _S_un_e__Union S_un;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SOCKADDR_IN
{
    public ushort sin_family;
    public ushort sin_port;
    public IN_ADDR sin_addr;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public sbyte[] sin_zero;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IN6_ADDR
{
    public _u_e__Union u;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SOCKADDR_IN6
{
    public ushort sin6_family;
    public ushort sin6_port;
    public uint sin6_flowinfo;
    public IN6_ADDR sin6_addr;
    public _Anonymous_e__Union Anonymous;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SOCKADDR_INET
{
    public SOCKADDR_IN Ipv4;
    public SOCKADDR_IN6 Ipv6;
    public ushort si_family;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NET_LUID_LH
{
    public ulong Value;
    public _Info_e__Struct Info;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MIB_IPPATH_ROW
{
    public SOCKADDR_INET Source;
    public SOCKADDR_INET Destination;
    public NET_LUID_LH InterfaceLuid;
    public uint InterfaceIndex;
    public SOCKADDR_INET CurrentNextHop;
    public uint PathMtu;
    public uint RttMean;
    public uint RttDeviation;
    public _Anonymous_e__Union Anonymous;
    [MarshalAs(UnmanagedType.U1)] public bool IsReachable;
    public ulong LinkTransmitSpeed;
    public ulong LinkReceiveSpeed;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MIB_IPPATH_TABLE
{
    public uint NumEntries;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public MIB_IPPATH_ROW[] Table;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IN_ADDR
    Public S_un As _S_un_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SOCKADDR_IN
    Public sin_family As UShort
    Public sin_port As UShort
    Public sin_addr As IN_ADDR
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public sin_zero() As SByte
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IN6_ADDR
    Public u As _u_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SOCKADDR_IN6
    Public sin6_family As UShort
    Public sin6_port As UShort
    Public sin6_flowinfo As UInteger
    Public sin6_addr As IN6_ADDR
    Public Anonymous As _Anonymous_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SOCKADDR_INET
    Public Ipv4 As SOCKADDR_IN
    Public Ipv6 As SOCKADDR_IN6
    Public si_family As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NET_LUID_LH
    Public Value As ULong
    Public Info As _Info_e__Struct
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MIB_IPPATH_ROW
    Public Source As SOCKADDR_INET
    Public Destination As SOCKADDR_INET
    Public InterfaceLuid As NET_LUID_LH
    Public InterfaceIndex As UInteger
    Public CurrentNextHop As SOCKADDR_INET
    Public PathMtu As UInteger
    Public RttMean As UInteger
    Public RttDeviation As UInteger
    Public Anonymous As _Anonymous_e__Union
    <MarshalAs(UnmanagedType.U1)> Public IsReachable As Boolean
    Public LinkTransmitSpeed As ULong
    Public LinkReceiveSpeed As ULong
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MIB_IPPATH_TABLE
    Public NumEntries As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public Table() As MIB_IPPATH_ROW
End Structure
import ctypes
from ctypes import wintypes

class IN_ADDR(ctypes.Structure):
    _fields_ = [
        ("S_un", _S_un_e__Union),
    ]

class SOCKADDR_IN(ctypes.Structure):
    _fields_ = [
        ("sin_family", ctypes.c_ushort),
        ("sin_port", ctypes.c_ushort),
        ("sin_addr", IN_ADDR),
        ("sin_zero", ctypes.c_byte * 8),
    ]

class IN6_ADDR(ctypes.Structure):
    _fields_ = [
        ("u", _u_e__Union),
    ]

class SOCKADDR_IN6(ctypes.Structure):
    _fields_ = [
        ("sin6_family", ctypes.c_ushort),
        ("sin6_port", ctypes.c_ushort),
        ("sin6_flowinfo", wintypes.DWORD),
        ("sin6_addr", IN6_ADDR),
        ("Anonymous", _Anonymous_e__Union),
    ]

class SOCKADDR_INET(ctypes.Structure):
    _fields_ = [
        ("Ipv4", SOCKADDR_IN),
        ("Ipv6", SOCKADDR_IN6),
        ("si_family", ctypes.c_ushort),
    ]

class NET_LUID_LH(ctypes.Structure):
    _fields_ = [
        ("Value", ctypes.c_ulonglong),
        ("Info", _Info_e__Struct),
    ]

class MIB_IPPATH_ROW(ctypes.Structure):
    _fields_ = [
        ("Source", SOCKADDR_INET),
        ("Destination", SOCKADDR_INET),
        ("InterfaceLuid", NET_LUID_LH),
        ("InterfaceIndex", wintypes.DWORD),
        ("CurrentNextHop", SOCKADDR_INET),
        ("PathMtu", wintypes.DWORD),
        ("RttMean", wintypes.DWORD),
        ("RttDeviation", wintypes.DWORD),
        ("Anonymous", _Anonymous_e__Union),
        ("IsReachable", ctypes.c_byte),
        ("LinkTransmitSpeed", ctypes.c_ulonglong),
        ("LinkReceiveSpeed", ctypes.c_ulonglong),
    ]

class MIB_IPPATH_TABLE(ctypes.Structure):
    _fields_ = [
        ("NumEntries", wintypes.DWORD),
        ("Table", MIB_IPPATH_ROW * 1),
    ]
#[repr(C)]
pub struct IN_ADDR {
    pub S_un: _S_un_e__Union,
}

#[repr(C)]
pub struct SOCKADDR_IN {
    pub sin_family: u16,
    pub sin_port: u16,
    pub sin_addr: IN_ADDR,
    pub sin_zero: [i8; 8],
}

#[repr(C)]
pub struct IN6_ADDR {
    pub u: _u_e__Union,
}

#[repr(C)]
pub struct SOCKADDR_IN6 {
    pub sin6_family: u16,
    pub sin6_port: u16,
    pub sin6_flowinfo: u32,
    pub sin6_addr: IN6_ADDR,
    pub Anonymous: _Anonymous_e__Union,
}

#[repr(C)]
pub struct SOCKADDR_INET {
    pub Ipv4: SOCKADDR_IN,
    pub Ipv6: SOCKADDR_IN6,
    pub si_family: u16,
}

#[repr(C)]
pub struct NET_LUID_LH {
    pub Value: u64,
    pub Info: _Info_e__Struct,
}

#[repr(C)]
pub struct MIB_IPPATH_ROW {
    pub Source: SOCKADDR_INET,
    pub Destination: SOCKADDR_INET,
    pub InterfaceLuid: NET_LUID_LH,
    pub InterfaceIndex: u32,
    pub CurrentNextHop: SOCKADDR_INET,
    pub PathMtu: u32,
    pub RttMean: u32,
    pub RttDeviation: u32,
    pub Anonymous: _Anonymous_e__Union,
    pub IsReachable: u8,
    pub LinkTransmitSpeed: u64,
    pub LinkReceiveSpeed: u64,
}

#[repr(C)]
pub struct MIB_IPPATH_TABLE {
    pub NumEntries: u32,
    pub Table: [MIB_IPPATH_ROW; 1],
}
import "golang.org/x/sys/windows"

type IN_ADDR struct {
	S_un _S_un_e__Union
}

type SOCKADDR_IN struct {
	sin_family uint16
	sin_port uint16
	sin_addr IN_ADDR
	sin_zero [8]int8
}

type IN6_ADDR struct {
	u _u_e__Union
}

type SOCKADDR_IN6 struct {
	sin6_family uint16
	sin6_port uint16
	sin6_flowinfo uint32
	sin6_addr IN6_ADDR
	Anonymous _Anonymous_e__Union
}

type SOCKADDR_INET struct {
	Ipv4 SOCKADDR_IN
	Ipv6 SOCKADDR_IN6
	si_family uint16
}

type NET_LUID_LH struct {
	Value uint64
	Info _Info_e__Struct
}

type MIB_IPPATH_ROW struct {
	Source SOCKADDR_INET
	Destination SOCKADDR_INET
	InterfaceLuid NET_LUID_LH
	InterfaceIndex uint32
	CurrentNextHop SOCKADDR_INET
	PathMtu uint32
	RttMean uint32
	RttDeviation uint32
	Anonymous _Anonymous_e__Union
	IsReachable byte
	LinkTransmitSpeed uint64
	LinkReceiveSpeed uint64
}

type MIB_IPPATH_TABLE struct {
	NumEntries uint32
	Table [1]MIB_IPPATH_ROW
}
type
  IN_ADDR = record
    S_un: _S_un_e__Union;
  end;

  SOCKADDR_IN = record
    sin_family: Word;
    sin_port: Word;
    sin_addr: IN_ADDR;
    sin_zero: array[0..7] of Shortint;
  end;

  IN6_ADDR = record
    u: _u_e__Union;
  end;

  SOCKADDR_IN6 = record
    sin6_family: Word;
    sin6_port: Word;
    sin6_flowinfo: DWORD;
    sin6_addr: IN6_ADDR;
    Anonymous: _Anonymous_e__Union;
  end;

  SOCKADDR_INET = record
    Ipv4: SOCKADDR_IN;
    Ipv6: SOCKADDR_IN6;
    si_family: Word;
  end;

  NET_LUID_LH = record
    Value: UInt64;
    Info: _Info_e__Struct;
  end;

  MIB_IPPATH_ROW = record
    Source: SOCKADDR_INET;
    Destination: SOCKADDR_INET;
    InterfaceLuid: NET_LUID_LH;
    InterfaceIndex: DWORD;
    CurrentNextHop: SOCKADDR_INET;
    PathMtu: DWORD;
    RttMean: DWORD;
    RttDeviation: DWORD;
    Anonymous: _Anonymous_e__Union;
    IsReachable: ByteBool;
    LinkTransmitSpeed: UInt64;
    LinkReceiveSpeed: UInt64;
  end;

  MIB_IPPATH_TABLE = record
    NumEntries: DWORD;
    Table: array[0..0] of MIB_IPPATH_ROW;
  end;
const IN_ADDR = extern struct {
    S_un: _S_un_e__Union,
};

const SOCKADDR_IN = extern struct {
    sin_family: u16,
    sin_port: u16,
    sin_addr: IN_ADDR,
    sin_zero: [8]i8,
};

const IN6_ADDR = extern struct {
    u: _u_e__Union,
};

const SOCKADDR_IN6 = extern struct {
    sin6_family: u16,
    sin6_port: u16,
    sin6_flowinfo: u32,
    sin6_addr: IN6_ADDR,
    Anonymous: _Anonymous_e__Union,
};

const SOCKADDR_INET = extern struct {
    Ipv4: SOCKADDR_IN,
    Ipv6: SOCKADDR_IN6,
    si_family: u16,
};

const NET_LUID_LH = extern struct {
    Value: u64,
    Info: _Info_e__Struct,
};

const MIB_IPPATH_ROW = extern struct {
    Source: SOCKADDR_INET,
    Destination: SOCKADDR_INET,
    InterfaceLuid: NET_LUID_LH,
    InterfaceIndex: u32,
    CurrentNextHop: SOCKADDR_INET,
    PathMtu: u32,
    RttMean: u32,
    RttDeviation: u32,
    Anonymous: _Anonymous_e__Union,
    IsReachable: u8,
    LinkTransmitSpeed: u64,
    LinkReceiveSpeed: u64,
};

const MIB_IPPATH_TABLE = extern struct {
    NumEntries: u32,
    Table: [1]MIB_IPPATH_ROW,
};
type
  IN_ADDR {.bycopy.} = object
    S_un: _S_un_e__Union

  SOCKADDR_IN {.bycopy.} = object
    sin_family: uint16
    sin_port: uint16
    sin_addr: IN_ADDR
    sin_zero: array[8, int8]

  IN6_ADDR {.bycopy.} = object
    u: _u_e__Union

  SOCKADDR_IN6 {.bycopy.} = object
    sin6_family: uint16
    sin6_port: uint16
    sin6_flowinfo: uint32
    sin6_addr: IN6_ADDR
    Anonymous: _Anonymous_e__Union

  SOCKADDR_INET {.bycopy.} = object
    Ipv4: SOCKADDR_IN
    Ipv6: SOCKADDR_IN6
    si_family: uint16

  NET_LUID_LH {.bycopy.} = object
    Value: uint64
    Info: _Info_e__Struct

  MIB_IPPATH_ROW {.bycopy.} = object
    Source: SOCKADDR_INET
    Destination: SOCKADDR_INET
    InterfaceLuid: NET_LUID_LH
    InterfaceIndex: uint32
    CurrentNextHop: SOCKADDR_INET
    PathMtu: uint32
    RttMean: uint32
    RttDeviation: uint32
    Anonymous: _Anonymous_e__Union
    IsReachable: uint8
    LinkTransmitSpeed: uint64
    LinkReceiveSpeed: uint64

  MIB_IPPATH_TABLE {.bycopy.} = object
    NumEntries: uint32
    Table: array[1, MIB_IPPATH_ROW]
struct IN_ADDR
{
    _S_un_e__Union S_un;
}

struct SOCKADDR_IN
{
    ushort sin_family;
    ushort sin_port;
    IN_ADDR sin_addr;
    byte[8] sin_zero;
}

struct IN6_ADDR
{
    _u_e__Union u;
}

struct SOCKADDR_IN6
{
    ushort sin6_family;
    ushort sin6_port;
    uint sin6_flowinfo;
    IN6_ADDR sin6_addr;
    _Anonymous_e__Union Anonymous;
}

struct SOCKADDR_INET
{
    SOCKADDR_IN Ipv4;
    SOCKADDR_IN6 Ipv6;
    ushort si_family;
}

struct NET_LUID_LH
{
    ulong Value;
    _Info_e__Struct Info;
}

struct MIB_IPPATH_ROW
{
    SOCKADDR_INET Source;
    SOCKADDR_INET Destination;
    NET_LUID_LH InterfaceLuid;
    uint InterfaceIndex;
    SOCKADDR_INET CurrentNextHop;
    uint PathMtu;
    uint RttMean;
    uint RttDeviation;
    _Anonymous_e__Union Anonymous;
    ubyte IsReachable;
    ulong LinkTransmitSpeed;
    ulong LinkReceiveSpeed;
}

struct MIB_IPPATH_TABLE
{
    uint NumEntries;
    MIB_IPPATH_ROW[1] Table;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; MIB_IPPATH_TABLE サイズ: 144 バイト(x86)
dim st, 36    ; 4byte整数×36(構造体サイズ 144 / 4 切り上げ)
; NumEntries : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Table : MIB_IPPATH_ROW (+8, 136byte)  varptr(st)+8 を基点に操作(136byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MIB_IPPATH_TABLE サイズ: 160 バイト(x64)
dim st, 40    ; 4byte整数×40(構造体サイズ 160 / 4 切り上げ)
; NumEntries : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Table : MIB_IPPATH_ROW (+8, 152byte)  varptr(st)+8 を基点に操作(152byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global MIB_IPPATH_ROW
    #field byte Source 32
    #field byte Destination 32
    #field byte InterfaceLuid 8
    #field int InterfaceIndex
    #field byte CurrentNextHop 32
    #field int PathMtu
    #field int RttMean
    #field int RttDeviation
    #field byte Anonymous 4
    #field bool1 IsReachable
    #field int64 LinkTransmitSpeed
    #field int64 LinkReceiveSpeed
#endstruct

#defstruct global MIB_IPPATH_TABLE
    #field int NumEntries
    #field MIB_IPPATH_ROW Table 1
#endstruct

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