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

FLOWDESCRIPTOR

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

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

フィールド

フィールドサイズx64x86説明
FlowSpecFLOWSPEC32+0+0フローの帯域幅特性を示すFLOWSPEC。
NumFiltersDWORD4+32+32FilterList配列内のフィルタ数。
FilterListRSVP_FILTERSPEC*8/4+40+36フローに適用するRSVP_FILTERSPEC配列へのポインタ。

各言語での定義

#include <windows.h>

// FLOWSPEC  (x64 32 / x86 32 バイト)
typedef struct FLOWSPEC {
    DWORD TokenRate;
    DWORD TokenBucketSize;
    DWORD PeakBandwidth;
    DWORD Latency;
    DWORD DelayVariation;
    DWORD ServiceType;
    DWORD MaxSduSize;
    DWORD MinimumPolicedSize;
} FLOWSPEC;

// FLOWDESCRIPTOR  (x64 48 / x86 40 バイト)
typedef struct FLOWDESCRIPTOR {
    FLOWSPEC FlowSpec;
    DWORD NumFilters;
    RSVP_FILTERSPEC* FilterList;
} FLOWDESCRIPTOR;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FLOWSPEC
{
    public uint TokenRate;
    public uint TokenBucketSize;
    public uint PeakBandwidth;
    public uint Latency;
    public uint DelayVariation;
    public uint ServiceType;
    public uint MaxSduSize;
    public uint MinimumPolicedSize;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FLOWDESCRIPTOR
{
    public FLOWSPEC FlowSpec;
    public uint NumFilters;
    public IntPtr FilterList;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FLOWSPEC
    Public TokenRate As UInteger
    Public TokenBucketSize As UInteger
    Public PeakBandwidth As UInteger
    Public Latency As UInteger
    Public DelayVariation As UInteger
    Public ServiceType As UInteger
    Public MaxSduSize As UInteger
    Public MinimumPolicedSize As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FLOWDESCRIPTOR
    Public FlowSpec As FLOWSPEC
    Public NumFilters As UInteger
    Public FilterList As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class FLOWSPEC(ctypes.Structure):
    _fields_ = [
        ("TokenRate", wintypes.DWORD),
        ("TokenBucketSize", wintypes.DWORD),
        ("PeakBandwidth", wintypes.DWORD),
        ("Latency", wintypes.DWORD),
        ("DelayVariation", wintypes.DWORD),
        ("ServiceType", wintypes.DWORD),
        ("MaxSduSize", wintypes.DWORD),
        ("MinimumPolicedSize", wintypes.DWORD),
    ]

class FLOWDESCRIPTOR(ctypes.Structure):
    _fields_ = [
        ("FlowSpec", FLOWSPEC),
        ("NumFilters", wintypes.DWORD),
        ("FilterList", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct FLOWSPEC {
    pub TokenRate: u32,
    pub TokenBucketSize: u32,
    pub PeakBandwidth: u32,
    pub Latency: u32,
    pub DelayVariation: u32,
    pub ServiceType: u32,
    pub MaxSduSize: u32,
    pub MinimumPolicedSize: u32,
}

#[repr(C)]
pub struct FLOWDESCRIPTOR {
    pub FlowSpec: FLOWSPEC,
    pub NumFilters: u32,
    pub FilterList: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type FLOWSPEC struct {
	TokenRate uint32
	TokenBucketSize uint32
	PeakBandwidth uint32
	Latency uint32
	DelayVariation uint32
	ServiceType uint32
	MaxSduSize uint32
	MinimumPolicedSize uint32
}

type FLOWDESCRIPTOR struct {
	FlowSpec FLOWSPEC
	NumFilters uint32
	FilterList uintptr
}
type
  FLOWSPEC = record
    TokenRate: DWORD;
    TokenBucketSize: DWORD;
    PeakBandwidth: DWORD;
    Latency: DWORD;
    DelayVariation: DWORD;
    ServiceType: DWORD;
    MaxSduSize: DWORD;
    MinimumPolicedSize: DWORD;
  end;

  FLOWDESCRIPTOR = record
    FlowSpec: FLOWSPEC;
    NumFilters: DWORD;
    FilterList: Pointer;
  end;
const FLOWSPEC = extern struct {
    TokenRate: u32,
    TokenBucketSize: u32,
    PeakBandwidth: u32,
    Latency: u32,
    DelayVariation: u32,
    ServiceType: u32,
    MaxSduSize: u32,
    MinimumPolicedSize: u32,
};

const FLOWDESCRIPTOR = extern struct {
    FlowSpec: FLOWSPEC,
    NumFilters: u32,
    FilterList: ?*anyopaque,
};
type
  FLOWSPEC {.bycopy.} = object
    TokenRate: uint32
    TokenBucketSize: uint32
    PeakBandwidth: uint32
    Latency: uint32
    DelayVariation: uint32
    ServiceType: uint32
    MaxSduSize: uint32
    MinimumPolicedSize: uint32

  FLOWDESCRIPTOR {.bycopy.} = object
    FlowSpec: FLOWSPEC
    NumFilters: uint32
    FilterList: pointer
struct FLOWSPEC
{
    uint TokenRate;
    uint TokenBucketSize;
    uint PeakBandwidth;
    uint Latency;
    uint DelayVariation;
    uint ServiceType;
    uint MaxSduSize;
    uint MinimumPolicedSize;
}

struct FLOWDESCRIPTOR
{
    FLOWSPEC FlowSpec;
    uint NumFilters;
    void* FilterList;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; FLOWDESCRIPTOR サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; FlowSpec : FLOWSPEC (+0, 32byte)  varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; NumFilters : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; FilterList : RSVP_FILTERSPEC* (+36, 4byte)  varptr(st)+36 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FLOWDESCRIPTOR サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; FlowSpec : FLOWSPEC (+0, 32byte)  varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; NumFilters : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; FilterList : RSVP_FILTERSPEC* (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FLOWSPEC
    #field int TokenRate
    #field int TokenBucketSize
    #field int PeakBandwidth
    #field int Latency
    #field int DelayVariation
    #field int ServiceType
    #field int MaxSduSize
    #field int MinimumPolicedSize
#endstruct

#defstruct global FLOWDESCRIPTOR
    #field FLOWSPEC FlowSpec
    #field int NumFilters
    #field intptr FilterList
#endstruct

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