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

MCAST_SCOPE_ENTRY

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

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

フィールド

フィールドサイズx64x86説明
ScopeCtxMCAST_SCOPE_CTX48+0+0このスコープを識別するコンテキスト(MCAST_SCOPE_CTX)である。
LastAddrIPNG_ADDRESS16+48+48スコープ内で割り当て可能な最後のアドレス(IPNG_ADDRESS)である。
TTLDWORD4+64+64このスコープのマルチキャストパケットのTTL(存続時間)である。
ScopeDescUNICODE_STRING16/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 Structure
import 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_STRING
struct 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 非対応)。必要に応じ手動でアクセス。