Win32 API 日本語リファレンス
ホームSystem.Rpc › MIDL_SYNTAX_INFO

MIDL_SYNTAX_INFO

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

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

フィールド

フィールドサイズx64x86説明
TransferSyntaxRPC_SYNTAX_IDENTIFIER20+0+0この情報が対応する転送構文の識別子(GUID+バージョン)。
DispatchTableRPC_DISPATCH_TABLE*8/4+24+20この構文用のRPCディスパッチテーブルへのポインタ。
ProcStringBYTE*8/4+32+24この構文用のプロシージャNDRフォーマット文字列へのポインタ。
FmtStringOffsetWORD*8/4+40+28各メソッドのProcString内オフセットを格納するWORD配列へのポインタ。
TypeStringBYTE*8/4+48+32型を記述するNDRフォーマット文字列へのポインタ。
aUserMarshalQuadruplevoid*8/4+56+36ユーザマーシャル用4要素ルーチン群へのポインタ。
pMethodPropertiesMIDL_INTERFACE_METHOD_PROPERTIES*8/4+64+40メソッドプロパティ情報(MIDL_INTERFACE_METHOD_PROPERTIES)へのポインタ。
pReserved2UINT_PTR8/4+72+44予約フィールド(ポインタサイズ整数)。将来の拡張用。

各言語での定義

#include <windows.h>

// RPC_VERSION  (x64 4 / x86 4 バイト)
typedef struct RPC_VERSION {
    WORD MajorVersion;
    WORD MinorVersion;
} RPC_VERSION;

// RPC_SYNTAX_IDENTIFIER  (x64 20 / x86 20 バイト)
typedef struct RPC_SYNTAX_IDENTIFIER {
    GUID SyntaxGUID;
    RPC_VERSION SyntaxVersion;
} RPC_SYNTAX_IDENTIFIER;

// MIDL_SYNTAX_INFO  (x64 80 / x86 48 バイト)
typedef struct MIDL_SYNTAX_INFO {
    RPC_SYNTAX_IDENTIFIER TransferSyntax;
    RPC_DISPATCH_TABLE* DispatchTable;
    BYTE* ProcString;
    WORD* FmtStringOffset;
    BYTE* TypeString;
    void* aUserMarshalQuadruple;
    MIDL_INTERFACE_METHOD_PROPERTIES* pMethodProperties;
    UINT_PTR pReserved2;
} MIDL_SYNTAX_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RPC_VERSION
{
    public ushort MajorVersion;
    public ushort MinorVersion;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RPC_SYNTAX_IDENTIFIER
{
    public Guid SyntaxGUID;
    public RPC_VERSION SyntaxVersion;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MIDL_SYNTAX_INFO
{
    public RPC_SYNTAX_IDENTIFIER TransferSyntax;
    public IntPtr DispatchTable;
    public IntPtr ProcString;
    public IntPtr FmtStringOffset;
    public IntPtr TypeString;
    public IntPtr aUserMarshalQuadruple;
    public IntPtr pMethodProperties;
    public UIntPtr pReserved2;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RPC_VERSION
    Public MajorVersion As UShort
    Public MinorVersion As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RPC_SYNTAX_IDENTIFIER
    Public SyntaxGUID As Guid
    Public SyntaxVersion As RPC_VERSION
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MIDL_SYNTAX_INFO
    Public TransferSyntax As RPC_SYNTAX_IDENTIFIER
    Public DispatchTable As IntPtr
    Public ProcString As IntPtr
    Public FmtStringOffset As IntPtr
    Public TypeString As IntPtr
    Public aUserMarshalQuadruple As IntPtr
    Public pMethodProperties As IntPtr
    Public pReserved2 As UIntPtr
End Structure
import ctypes
from ctypes import wintypes

class RPC_VERSION(ctypes.Structure):
    _fields_ = [
        ("MajorVersion", ctypes.c_ushort),
        ("MinorVersion", ctypes.c_ushort),
    ]

class RPC_SYNTAX_IDENTIFIER(ctypes.Structure):
    _fields_ = [
        ("SyntaxGUID", GUID),
        ("SyntaxVersion", RPC_VERSION),
    ]

class MIDL_SYNTAX_INFO(ctypes.Structure):
    _fields_ = [
        ("TransferSyntax", RPC_SYNTAX_IDENTIFIER),
        ("DispatchTable", ctypes.c_void_p),
        ("ProcString", ctypes.c_void_p),
        ("FmtStringOffset", ctypes.c_void_p),
        ("TypeString", ctypes.c_void_p),
        ("aUserMarshalQuadruple", ctypes.c_void_p),
        ("pMethodProperties", ctypes.c_void_p),
        ("pReserved2", ctypes.c_size_t),
    ]
#[repr(C)]
pub struct RPC_VERSION {
    pub MajorVersion: u16,
    pub MinorVersion: u16,
}

#[repr(C)]
pub struct RPC_SYNTAX_IDENTIFIER {
    pub SyntaxGUID: GUID,
    pub SyntaxVersion: RPC_VERSION,
}

#[repr(C)]
pub struct MIDL_SYNTAX_INFO {
    pub TransferSyntax: RPC_SYNTAX_IDENTIFIER,
    pub DispatchTable: *mut core::ffi::c_void,
    pub ProcString: *mut core::ffi::c_void,
    pub FmtStringOffset: *mut core::ffi::c_void,
    pub TypeString: *mut core::ffi::c_void,
    pub aUserMarshalQuadruple: *mut core::ffi::c_void,
    pub pMethodProperties: *mut core::ffi::c_void,
    pub pReserved2: usize,
}
import "golang.org/x/sys/windows"

type RPC_VERSION struct {
	MajorVersion uint16
	MinorVersion uint16
}

type RPC_SYNTAX_IDENTIFIER struct {
	SyntaxGUID windows.GUID
	SyntaxVersion RPC_VERSION
}

type MIDL_SYNTAX_INFO struct {
	TransferSyntax RPC_SYNTAX_IDENTIFIER
	DispatchTable uintptr
	ProcString uintptr
	FmtStringOffset uintptr
	TypeString uintptr
	aUserMarshalQuadruple uintptr
	pMethodProperties uintptr
	pReserved2 uintptr
}
type
  RPC_VERSION = record
    MajorVersion: Word;
    MinorVersion: Word;
  end;

  RPC_SYNTAX_IDENTIFIER = record
    SyntaxGUID: TGUID;
    SyntaxVersion: RPC_VERSION;
  end;

  MIDL_SYNTAX_INFO = record
    TransferSyntax: RPC_SYNTAX_IDENTIFIER;
    DispatchTable: Pointer;
    ProcString: Pointer;
    FmtStringOffset: Pointer;
    TypeString: Pointer;
    aUserMarshalQuadruple: Pointer;
    pMethodProperties: Pointer;
    pReserved2: NativeUInt;
  end;
const RPC_VERSION = extern struct {
    MajorVersion: u16,
    MinorVersion: u16,
};

const RPC_SYNTAX_IDENTIFIER = extern struct {
    SyntaxGUID: GUID,
    SyntaxVersion: RPC_VERSION,
};

const MIDL_SYNTAX_INFO = extern struct {
    TransferSyntax: RPC_SYNTAX_IDENTIFIER,
    DispatchTable: ?*anyopaque,
    ProcString: ?*anyopaque,
    FmtStringOffset: ?*anyopaque,
    TypeString: ?*anyopaque,
    aUserMarshalQuadruple: ?*anyopaque,
    pMethodProperties: ?*anyopaque,
    pReserved2: usize,
};
type
  RPC_VERSION {.bycopy.} = object
    MajorVersion: uint16
    MinorVersion: uint16

  RPC_SYNTAX_IDENTIFIER {.bycopy.} = object
    SyntaxGUID: GUID
    SyntaxVersion: RPC_VERSION

  MIDL_SYNTAX_INFO {.bycopy.} = object
    TransferSyntax: RPC_SYNTAX_IDENTIFIER
    DispatchTable: pointer
    ProcString: pointer
    FmtStringOffset: pointer
    TypeString: pointer
    aUserMarshalQuadruple: pointer
    pMethodProperties: pointer
    pReserved2: uint
struct RPC_VERSION
{
    ushort MajorVersion;
    ushort MinorVersion;
}

struct RPC_SYNTAX_IDENTIFIER
{
    GUID SyntaxGUID;
    RPC_VERSION SyntaxVersion;
}

struct MIDL_SYNTAX_INFO
{
    RPC_SYNTAX_IDENTIFIER TransferSyntax;
    void* DispatchTable;
    void* ProcString;
    void* FmtStringOffset;
    void* TypeString;
    void* aUserMarshalQuadruple;
    void* pMethodProperties;
    size_t pReserved2;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; MIDL_SYNTAX_INFO サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; TransferSyntax : RPC_SYNTAX_IDENTIFIER (+0, 20byte)  varptr(st)+0 を基点に操作(20byte:入れ子/配列)
; DispatchTable : RPC_DISPATCH_TABLE* (+20, 4byte)  varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; ProcString : BYTE* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; FmtStringOffset : WORD* (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; TypeString : BYTE* (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; aUserMarshalQuadruple : void* (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; pMethodProperties : MIDL_INTERFACE_METHOD_PROPERTIES* (+40, 4byte)  varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; pReserved2 : UINT_PTR (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MIDL_SYNTAX_INFO サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; TransferSyntax : RPC_SYNTAX_IDENTIFIER (+0, 20byte)  varptr(st)+0 を基点に操作(20byte:入れ子/配列)
; DispatchTable : RPC_DISPATCH_TABLE* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ProcString : BYTE* (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; FmtStringOffset : WORD* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; TypeString : BYTE* (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; aUserMarshalQuadruple : void* (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pMethodProperties : MIDL_INTERFACE_METHOD_PROPERTIES* (+64, 8byte)  varptr(st)+64 を基点に操作(8byte:入れ子/配列)
; pReserved2 : UINT_PTR (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global RPC_VERSION
    #field short MajorVersion
    #field short MinorVersion
#endstruct

#defstruct global RPC_SYNTAX_IDENTIFIER
    #field GUID SyntaxGUID
    #field RPC_VERSION SyntaxVersion
#endstruct

#defstruct global MIDL_SYNTAX_INFO
    #field RPC_SYNTAX_IDENTIFIER TransferSyntax
    #field intptr DispatchTable
    #field intptr ProcString
    #field intptr FmtStringOffset
    #field intptr TypeString
    #field intptr aUserMarshalQuadruple
    #field intptr pMethodProperties
    #field intptr pReserved2
#endstruct

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