ホーム › NetworkManagement.Multicast › MCAST_SCOPE_ENTRY
MCAST_SCOPE_ENTRY
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| ScopeCtx | MCAST_SCOPE_CTX | 48 | +0 | +0 | このスコープを識別するコンテキスト(MCAST_SCOPE_CTX)である。 |
| LastAddr | IPNG_ADDRESS | 16 | +48 | +48 | スコープ内で割り当て可能な最後のアドレス(IPNG_ADDRESS)である。 |
| TTL | DWORD | 4 | +64 | +64 | このスコープのマルチキャストパケットのTTL(存続時間)である。 |
| ScopeDesc | UNICODE_STRING | 16/8 | +72 | +68 | スコープの説明文を保持するUNICODE_STRINGである。 |
各言語での定義
#include <windows.h>
// IPNG_ADDRESS (x64 16 / x86 16 バイト)
typedef struct IPNG_ADDRESS {
DWORD IpAddrV4;
BYTE IpAddrV6[16];
} IPNG_ADDRESS;
// MCAST_SCOPE_CTX (x64 48 / x86 48 バイト)
typedef struct MCAST_SCOPE_CTX {
IPNG_ADDRESS ScopeID;
IPNG_ADDRESS Interface;
IPNG_ADDRESS ServerID;
} MCAST_SCOPE_CTX;
// UNICODE_STRING (x64 16 / x86 8 バイト)
typedef struct UNICODE_STRING {
WORD Length;
WORD MaximumLength;
LPWSTR Buffer;
} UNICODE_STRING;
// MCAST_SCOPE_ENTRY (x64 88 / x86 76 バイト)
typedef struct MCAST_SCOPE_ENTRY {
MCAST_SCOPE_CTX ScopeCtx;
IPNG_ADDRESS LastAddr;
DWORD TTL;
UNICODE_STRING ScopeDesc;
} MCAST_SCOPE_ENTRY;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IPNG_ADDRESS
{
public uint IpAddrV4;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public byte[] IpAddrV6;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MCAST_SCOPE_CTX
{
public IPNG_ADDRESS ScopeID;
public IPNG_ADDRESS Interface;
public IPNG_ADDRESS ServerID;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct UNICODE_STRING
{
public ushort Length;
public ushort MaximumLength;
public IntPtr Buffer;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MCAST_SCOPE_ENTRY
{
public MCAST_SCOPE_CTX ScopeCtx;
public IPNG_ADDRESS LastAddr;
public uint TTL;
public UNICODE_STRING ScopeDesc;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IPNG_ADDRESS
Public IpAddrV4 As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public IpAddrV6() As Byte
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MCAST_SCOPE_CTX
Public ScopeID As IPNG_ADDRESS
Public Interface As IPNG_ADDRESS
Public ServerID As IPNG_ADDRESS
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure UNICODE_STRING
Public Length As UShort
Public MaximumLength As UShort
Public Buffer As IntPtr
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MCAST_SCOPE_ENTRY
Public ScopeCtx As MCAST_SCOPE_CTX
Public LastAddr As IPNG_ADDRESS
Public TTL As UInteger
Public ScopeDesc As UNICODE_STRING
End Structureimport ctypes
from ctypes import wintypes
class IPNG_ADDRESS(ctypes.Structure):
_fields_ = [
("IpAddrV4", wintypes.DWORD),
("IpAddrV6", ctypes.c_ubyte * 16),
]
class MCAST_SCOPE_CTX(ctypes.Structure):
_fields_ = [
("ScopeID", IPNG_ADDRESS),
("Interface", IPNG_ADDRESS),
("ServerID", IPNG_ADDRESS),
]
class UNICODE_STRING(ctypes.Structure):
_fields_ = [
("Length", ctypes.c_ushort),
("MaximumLength", ctypes.c_ushort),
("Buffer", ctypes.c_void_p),
]
class MCAST_SCOPE_ENTRY(ctypes.Structure):
_fields_ = [
("ScopeCtx", MCAST_SCOPE_CTX),
("LastAddr", IPNG_ADDRESS),
("TTL", wintypes.DWORD),
("ScopeDesc", UNICODE_STRING),
]#[repr(C)]
pub struct IPNG_ADDRESS {
pub IpAddrV4: u32,
pub IpAddrV6: [u8; 16],
}
#[repr(C)]
pub struct MCAST_SCOPE_CTX {
pub ScopeID: IPNG_ADDRESS,
pub Interface: IPNG_ADDRESS,
pub ServerID: IPNG_ADDRESS,
}
#[repr(C)]
pub struct UNICODE_STRING {
pub Length: u16,
pub MaximumLength: u16,
pub Buffer: *mut core::ffi::c_void,
}
#[repr(C)]
pub struct MCAST_SCOPE_ENTRY {
pub ScopeCtx: MCAST_SCOPE_CTX,
pub LastAddr: IPNG_ADDRESS,
pub TTL: u32,
pub ScopeDesc: UNICODE_STRING,
}import "golang.org/x/sys/windows"
type IPNG_ADDRESS struct {
IpAddrV4 uint32
IpAddrV6 [16]byte
}
type MCAST_SCOPE_CTX struct {
ScopeID IPNG_ADDRESS
Interface IPNG_ADDRESS
ServerID IPNG_ADDRESS
}
type UNICODE_STRING struct {
Length uint16
MaximumLength uint16
Buffer uintptr
}
type MCAST_SCOPE_ENTRY struct {
ScopeCtx MCAST_SCOPE_CTX
LastAddr IPNG_ADDRESS
TTL uint32
ScopeDesc UNICODE_STRING
}type
IPNG_ADDRESS = record
IpAddrV4: DWORD;
IpAddrV6: array[0..15] of Byte;
end;
MCAST_SCOPE_CTX = record
ScopeID: IPNG_ADDRESS;
Interface: IPNG_ADDRESS;
ServerID: IPNG_ADDRESS;
end;
UNICODE_STRING = record
Length: Word;
MaximumLength: Word;
Buffer: Pointer;
end;
MCAST_SCOPE_ENTRY = record
ScopeCtx: MCAST_SCOPE_CTX;
LastAddr: IPNG_ADDRESS;
TTL: DWORD;
ScopeDesc: UNICODE_STRING;
end;const IPNG_ADDRESS = extern struct {
IpAddrV4: u32,
IpAddrV6: [16]u8,
};
const MCAST_SCOPE_CTX = extern struct {
ScopeID: IPNG_ADDRESS,
Interface: IPNG_ADDRESS,
ServerID: IPNG_ADDRESS,
};
const UNICODE_STRING = extern struct {
Length: u16,
MaximumLength: u16,
Buffer: ?*anyopaque,
};
const MCAST_SCOPE_ENTRY = extern struct {
ScopeCtx: MCAST_SCOPE_CTX,
LastAddr: IPNG_ADDRESS,
TTL: u32,
ScopeDesc: UNICODE_STRING,
};type
IPNG_ADDRESS {.bycopy.} = object
IpAddrV4: uint32
IpAddrV6: array[16, uint8]
MCAST_SCOPE_CTX {.bycopy.} = object
ScopeID: IPNG_ADDRESS
Interface: IPNG_ADDRESS
ServerID: IPNG_ADDRESS
UNICODE_STRING {.bycopy.} = object
Length: uint16
MaximumLength: uint16
Buffer: pointer
MCAST_SCOPE_ENTRY {.bycopy.} = object
ScopeCtx: MCAST_SCOPE_CTX
LastAddr: IPNG_ADDRESS
TTL: uint32
ScopeDesc: UNICODE_STRINGstruct IPNG_ADDRESS
{
uint IpAddrV4;
ubyte[16] IpAddrV6;
}
struct MCAST_SCOPE_CTX
{
IPNG_ADDRESS ScopeID;
IPNG_ADDRESS Interface;
IPNG_ADDRESS ServerID;
}
struct UNICODE_STRING
{
ushort Length;
ushort MaximumLength;
void* Buffer;
}
struct MCAST_SCOPE_ENTRY
{
MCAST_SCOPE_CTX ScopeCtx;
IPNG_ADDRESS LastAddr;
uint TTL;
UNICODE_STRING ScopeDesc;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; MCAST_SCOPE_ENTRY サイズ: 76 バイト(x86)
dim st, 19 ; 4byte整数×19(構造体サイズ 76 / 4 切り上げ)
; ScopeCtx : MCAST_SCOPE_CTX (+0, 48byte) varptr(st)+0 を基点に操作(48byte:入れ子/配列)
; LastAddr : IPNG_ADDRESS (+48, 16byte) varptr(st)+48 を基点に操作(16byte:入れ子/配列)
; TTL : DWORD (+64, 4byte) st.16 = 値 / 値 = st.16 (lpoke/lpeek も可)
; ScopeDesc : UNICODE_STRING (+68, 8byte) varptr(st)+68 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MCAST_SCOPE_ENTRY サイズ: 88 バイト(x64)
dim st, 22 ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; ScopeCtx : MCAST_SCOPE_CTX (+0, 48byte) varptr(st)+0 を基点に操作(48byte:入れ子/配列)
; LastAddr : IPNG_ADDRESS (+48, 16byte) varptr(st)+48 を基点に操作(16byte:入れ子/配列)
; TTL : DWORD (+64, 4byte) st.16 = 値 / 値 = st.16 (lpoke/lpeek も可)
; ScopeDesc : UNICODE_STRING (+72, 16byte) varptr(st)+72 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global MCAST_SCOPE_CTX
#field byte ScopeID 16
#field byte Interface 16
#field byte ServerID 16
#endstruct
#defstruct global UNICODE_STRING
#field short Length
#field short MaximumLength
#field intptr Buffer
#endstruct
#defstruct global MCAST_SCOPE_ENTRY
#field MCAST_SCOPE_CTX ScopeCtx
#field byte LastAddr 16
#field int TTL
#field UNICODE_STRING ScopeDesc
#endstruct
stdim st, MCAST_SCOPE_ENTRY ; NSTRUCT 変数を確保
st->TTL = 100
mes "TTL=" + st->TTL
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。