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

RAS_STATS

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 60 バイト / x86: 60 バイト

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

フィールド

フィールド型サイズx64x86説明
dwSizeDWORD4+0+0構造体のバージョンを指定します。この構造体を関数呼び出しで使用する前に、このメンバーに sizeof(RAS_STATS) を設定します。
dwBytesXmitedDWORD4+4+4この接続またはリンクを通じて送信されたバイト数です。
dwBytesRcvedDWORD4+8+8この接続またはリンクを通じて受信したバイト数です。
dwFramesXmitedDWORD4+12+12この接続またはリンクを通じて送信されたフレーム数です。
dwFramesRcvedDWORD4+16+16この接続またはリンクを通じて受信したフレーム数です。
dwCrcErrDWORD4+20+20この接続またはリンクで発生した巡回冗長検査 (CRC) エラーの数です。
dwTimeoutErrDWORD4+24+24この接続またはリンクで発生したタイムアウトエラーの数です。
dwAlignmentErrDWORD4+28+28この接続またはリンクで発生したアラインメントエラーの数です。
dwHardwareOverrunErrDWORD4+32+32この接続またはリンクで発生したハードウェアオーバーランエラーの数です。
dwFramingErrDWORD4+36+36この接続またはリンクで発生したフレーミングエラーの数です。
dwBufferOverrunErrDWORD4+40+40この接続またはリンクで発生したバッファーオーバーランエラーの数です。
dwCompressionRatioInDWORD4+44+44

この接続またはリンクで受信するデータの圧縮率です。

Note この要素は、単一リンク接続、またはマルチリンク接続内の 1 つのリンクに対してのみ有効です。
dwCompressionRatioOutDWORD4+48+48

この接続またはリンクで送信するデータの圧縮率です。

Note この要素は、単一リンク接続、またはマルチリンク接続内の 1 つのリンクに対してのみ有効です。
dwBpsDWORD4+52+52

接続またはリンクの速度 (ビット/秒単位) です。

単一リンク接続、およびマルチリンク接続内の個々のリンクの場合、この速度は接続またはリンクが確立された時点でネゴシエートされます。

マルチリンク接続の場合、この速度は個々のリンクの速度の合計に等しくなります。マルチリンク接続では、リンクが追加または削除されるのに応じてこの速度は変化します。

この速度は接続またはリンクのスループットとは異なります。平均スループットを算出するには、送信バイト数 (dwBytesXmited) と受信バイト数 (dwBytesRcved) を、接続またはリンクが接続されていた時間 (dwConnectDuration) で割ります。

dwConnectDurationDWORD4+56+56接続またはリンクが接続されている時間 (ミリ秒単位) です。

公式ドキュメント

RAS_STATS 構造体は、単一リンクの RAS 接続、またはマルチリンク RAS 接続内の 1 つのリンクに関する統計情報を格納します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// RAS_STATS  (x64 60 / x86 60 バイト)
typedef struct RAS_STATS {
    DWORD dwSize;
    DWORD dwBytesXmited;
    DWORD dwBytesRcved;
    DWORD dwFramesXmited;
    DWORD dwFramesRcved;
    DWORD dwCrcErr;
    DWORD dwTimeoutErr;
    DWORD dwAlignmentErr;
    DWORD dwHardwareOverrunErr;
    DWORD dwFramingErr;
    DWORD dwBufferOverrunErr;
    DWORD dwCompressionRatioIn;
    DWORD dwCompressionRatioOut;
    DWORD dwBps;
    DWORD dwConnectDuration;
} RAS_STATS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RAS_STATS
{
    public uint dwSize;
    public uint dwBytesXmited;
    public uint dwBytesRcved;
    public uint dwFramesXmited;
    public uint dwFramesRcved;
    public uint dwCrcErr;
    public uint dwTimeoutErr;
    public uint dwAlignmentErr;
    public uint dwHardwareOverrunErr;
    public uint dwFramingErr;
    public uint dwBufferOverrunErr;
    public uint dwCompressionRatioIn;
    public uint dwCompressionRatioOut;
    public uint dwBps;
    public uint dwConnectDuration;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RAS_STATS
    Public dwSize As UInteger
    Public dwBytesXmited As UInteger
    Public dwBytesRcved As UInteger
    Public dwFramesXmited As UInteger
    Public dwFramesRcved As UInteger
    Public dwCrcErr As UInteger
    Public dwTimeoutErr As UInteger
    Public dwAlignmentErr As UInteger
    Public dwHardwareOverrunErr As UInteger
    Public dwFramingErr As UInteger
    Public dwBufferOverrunErr As UInteger
    Public dwCompressionRatioIn As UInteger
    Public dwCompressionRatioOut As UInteger
    Public dwBps As UInteger
    Public dwConnectDuration As UInteger
End Structure
import ctypes
from ctypes import wintypes

class RAS_STATS(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwBytesXmited", wintypes.DWORD),
        ("dwBytesRcved", wintypes.DWORD),
        ("dwFramesXmited", wintypes.DWORD),
        ("dwFramesRcved", wintypes.DWORD),
        ("dwCrcErr", wintypes.DWORD),
        ("dwTimeoutErr", wintypes.DWORD),
        ("dwAlignmentErr", wintypes.DWORD),
        ("dwHardwareOverrunErr", wintypes.DWORD),
        ("dwFramingErr", wintypes.DWORD),
        ("dwBufferOverrunErr", wintypes.DWORD),
        ("dwCompressionRatioIn", wintypes.DWORD),
        ("dwCompressionRatioOut", wintypes.DWORD),
        ("dwBps", wintypes.DWORD),
        ("dwConnectDuration", wintypes.DWORD),
    ]
#[repr(C)]
pub struct RAS_STATS {
    pub dwSize: u32,
    pub dwBytesXmited: u32,
    pub dwBytesRcved: u32,
    pub dwFramesXmited: u32,
    pub dwFramesRcved: u32,
    pub dwCrcErr: u32,
    pub dwTimeoutErr: u32,
    pub dwAlignmentErr: u32,
    pub dwHardwareOverrunErr: u32,
    pub dwFramingErr: u32,
    pub dwBufferOverrunErr: u32,
    pub dwCompressionRatioIn: u32,
    pub dwCompressionRatioOut: u32,
    pub dwBps: u32,
    pub dwConnectDuration: u32,
}
import "golang.org/x/sys/windows"

type RAS_STATS struct {
	dwSize uint32
	dwBytesXmited uint32
	dwBytesRcved uint32
	dwFramesXmited uint32
	dwFramesRcved uint32
	dwCrcErr uint32
	dwTimeoutErr uint32
	dwAlignmentErr uint32
	dwHardwareOverrunErr uint32
	dwFramingErr uint32
	dwBufferOverrunErr uint32
	dwCompressionRatioIn uint32
	dwCompressionRatioOut uint32
	dwBps uint32
	dwConnectDuration uint32
}
type
  RAS_STATS = record
    dwSize: DWORD;
    dwBytesXmited: DWORD;
    dwBytesRcved: DWORD;
    dwFramesXmited: DWORD;
    dwFramesRcved: DWORD;
    dwCrcErr: DWORD;
    dwTimeoutErr: DWORD;
    dwAlignmentErr: DWORD;
    dwHardwareOverrunErr: DWORD;
    dwFramingErr: DWORD;
    dwBufferOverrunErr: DWORD;
    dwCompressionRatioIn: DWORD;
    dwCompressionRatioOut: DWORD;
    dwBps: DWORD;
    dwConnectDuration: DWORD;
  end;
const RAS_STATS = extern struct {
    dwSize: u32,
    dwBytesXmited: u32,
    dwBytesRcved: u32,
    dwFramesXmited: u32,
    dwFramesRcved: u32,
    dwCrcErr: u32,
    dwTimeoutErr: u32,
    dwAlignmentErr: u32,
    dwHardwareOverrunErr: u32,
    dwFramingErr: u32,
    dwBufferOverrunErr: u32,
    dwCompressionRatioIn: u32,
    dwCompressionRatioOut: u32,
    dwBps: u32,
    dwConnectDuration: u32,
};
type
  RAS_STATS {.bycopy.} = object
    dwSize: uint32
    dwBytesXmited: uint32
    dwBytesRcved: uint32
    dwFramesXmited: uint32
    dwFramesRcved: uint32
    dwCrcErr: uint32
    dwTimeoutErr: uint32
    dwAlignmentErr: uint32
    dwHardwareOverrunErr: uint32
    dwFramingErr: uint32
    dwBufferOverrunErr: uint32
    dwCompressionRatioIn: uint32
    dwCompressionRatioOut: uint32
    dwBps: uint32
    dwConnectDuration: uint32
struct RAS_STATS
{
    uint dwSize;
    uint dwBytesXmited;
    uint dwBytesRcved;
    uint dwFramesXmited;
    uint dwFramesRcved;
    uint dwCrcErr;
    uint dwTimeoutErr;
    uint dwAlignmentErr;
    uint dwHardwareOverrunErr;
    uint dwFramingErr;
    uint dwBufferOverrunErr;
    uint dwCompressionRatioIn;
    uint dwCompressionRatioOut;
    uint dwBps;
    uint dwConnectDuration;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RAS_STATS サイズ: 60 バイト(x64)
dim st, 15    ; 4byte整数×15(構造体サイズ 60 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwBytesXmited : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwBytesRcved : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwFramesXmited : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwFramesRcved : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwCrcErr : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwTimeoutErr : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwAlignmentErr : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwHardwareOverrunErr : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwFramingErr : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dwBufferOverrunErr : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwCompressionRatioIn : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwCompressionRatioOut : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwBps : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; dwConnectDuration : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global RAS_STATS
    #field int dwSize
    #field int dwBytesXmited
    #field int dwBytesRcved
    #field int dwFramesXmited
    #field int dwFramesRcved
    #field int dwCrcErr
    #field int dwTimeoutErr
    #field int dwAlignmentErr
    #field int dwHardwareOverrunErr
    #field int dwFramingErr
    #field int dwBufferOverrunErr
    #field int dwCompressionRatioIn
    #field int dwCompressionRatioOut
    #field int dwBps
    #field int dwConnectDuration
#endstruct

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