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

PATCH_OPTION_DATA

構造体
サイズx64: 64 バイト / x86: 36 バイト

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

フィールド

フィールド型サイズx64x86説明
SizeOfThisStructDWORD4+0+0この構造体のバイトサイズ。
SymbolOptionFlagsDWORD4+4+4シンボル処理に関するオプションフラグ。
NewFileSymbolPathLPSTR8/4+8+8新ファイルのシンボルファイル検索パス文字列。NULL可。
OldFileSymbolPathArrayLPSTR*8/4+16+12各旧ファイルのシンボルパス文字列配列へのポインタ。
ExtendedOptionFlagsDWORD4+24+16拡張オプションを示すフラグ。PATCH_OPTION_系を指定する。
SymLoadCallbackPPATCH_SYMLOAD_CALLBACK8/4+32+20シンボル読み込み時に呼ばれるコールバック関数へのポインタ。NULL可。
SymLoadContextvoid*8/4+40+24SymLoadCallbackに渡すユーザー定義コンテキストへのポインタ。
InterleaveMapArrayPATCH_INTERLEAVE_MAP**8/4+48+28旧ファイルごとのインターリーブマップ配列へのポインタ。
MaxLzxWindowSizeDWORD4+56+32LZX圧縮で使用する最大ウィンドウサイズ(バイト)。

各言語での定義

#include <windows.h>

// PATCH_OPTION_DATA  (x64 64 / x86 36 バイト)
typedef struct PATCH_OPTION_DATA {
    DWORD SizeOfThisStruct;
    DWORD SymbolOptionFlags;
    LPSTR NewFileSymbolPath;
    LPSTR* OldFileSymbolPathArray;
    DWORD ExtendedOptionFlags;
    PPATCH_SYMLOAD_CALLBACK SymLoadCallback;
    void* SymLoadContext;
    PATCH_INTERLEAVE_MAP** InterleaveMapArray;
    DWORD MaxLzxWindowSize;
} PATCH_OPTION_DATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PATCH_OPTION_DATA
{
    public uint SizeOfThisStruct;
    public uint SymbolOptionFlags;
    public IntPtr NewFileSymbolPath;
    public IntPtr OldFileSymbolPathArray;
    public uint ExtendedOptionFlags;
    public IntPtr SymLoadCallback;
    public IntPtr SymLoadContext;
    public IntPtr InterleaveMapArray;
    public uint MaxLzxWindowSize;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PATCH_OPTION_DATA
    Public SizeOfThisStruct As UInteger
    Public SymbolOptionFlags As UInteger
    Public NewFileSymbolPath As IntPtr
    Public OldFileSymbolPathArray As IntPtr
    Public ExtendedOptionFlags As UInteger
    Public SymLoadCallback As IntPtr
    Public SymLoadContext As IntPtr
    Public InterleaveMapArray As IntPtr
    Public MaxLzxWindowSize As UInteger
End Structure
import ctypes
from ctypes import wintypes

class PATCH_OPTION_DATA(ctypes.Structure):
    _fields_ = [
        ("SizeOfThisStruct", wintypes.DWORD),
        ("SymbolOptionFlags", wintypes.DWORD),
        ("NewFileSymbolPath", ctypes.c_void_p),
        ("OldFileSymbolPathArray", ctypes.c_void_p),
        ("ExtendedOptionFlags", wintypes.DWORD),
        ("SymLoadCallback", ctypes.c_void_p),
        ("SymLoadContext", ctypes.c_void_p),
        ("InterleaveMapArray", ctypes.c_void_p),
        ("MaxLzxWindowSize", wintypes.DWORD),
    ]
#[repr(C)]
pub struct PATCH_OPTION_DATA {
    pub SizeOfThisStruct: u32,
    pub SymbolOptionFlags: u32,
    pub NewFileSymbolPath: *mut core::ffi::c_void,
    pub OldFileSymbolPathArray: *mut core::ffi::c_void,
    pub ExtendedOptionFlags: u32,
    pub SymLoadCallback: *mut core::ffi::c_void,
    pub SymLoadContext: *mut core::ffi::c_void,
    pub InterleaveMapArray: *mut core::ffi::c_void,
    pub MaxLzxWindowSize: u32,
}
import "golang.org/x/sys/windows"

type PATCH_OPTION_DATA struct {
	SizeOfThisStruct uint32
	SymbolOptionFlags uint32
	NewFileSymbolPath uintptr
	OldFileSymbolPathArray uintptr
	ExtendedOptionFlags uint32
	SymLoadCallback uintptr
	SymLoadContext uintptr
	InterleaveMapArray uintptr
	MaxLzxWindowSize uint32
}
type
  PATCH_OPTION_DATA = record
    SizeOfThisStruct: DWORD;
    SymbolOptionFlags: DWORD;
    NewFileSymbolPath: Pointer;
    OldFileSymbolPathArray: Pointer;
    ExtendedOptionFlags: DWORD;
    SymLoadCallback: Pointer;
    SymLoadContext: Pointer;
    InterleaveMapArray: Pointer;
    MaxLzxWindowSize: DWORD;
  end;
const PATCH_OPTION_DATA = extern struct {
    SizeOfThisStruct: u32,
    SymbolOptionFlags: u32,
    NewFileSymbolPath: ?*anyopaque,
    OldFileSymbolPathArray: ?*anyopaque,
    ExtendedOptionFlags: u32,
    SymLoadCallback: ?*anyopaque,
    SymLoadContext: ?*anyopaque,
    InterleaveMapArray: ?*anyopaque,
    MaxLzxWindowSize: u32,
};
type
  PATCH_OPTION_DATA {.bycopy.} = object
    SizeOfThisStruct: uint32
    SymbolOptionFlags: uint32
    NewFileSymbolPath: pointer
    OldFileSymbolPathArray: pointer
    ExtendedOptionFlags: uint32
    SymLoadCallback: pointer
    SymLoadContext: pointer
    InterleaveMapArray: pointer
    MaxLzxWindowSize: uint32
struct PATCH_OPTION_DATA
{
    uint SizeOfThisStruct;
    uint SymbolOptionFlags;
    void* NewFileSymbolPath;
    void* OldFileSymbolPathArray;
    uint ExtendedOptionFlags;
    void* SymLoadCallback;
    void* SymLoadContext;
    void* InterleaveMapArray;
    uint MaxLzxWindowSize;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PATCH_OPTION_DATA サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; SizeOfThisStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; SymbolOptionFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; NewFileSymbolPath : LPSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; OldFileSymbolPathArray : LPSTR* (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ExtendedOptionFlags : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; SymLoadCallback : PPATCH_SYMLOAD_CALLBACK (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; SymLoadContext : void* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; InterleaveMapArray : PATCH_INTERLEAVE_MAP** (+28, 4byte)  varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; MaxLzxWindowSize : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PATCH_OPTION_DATA サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; SizeOfThisStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; SymbolOptionFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; NewFileSymbolPath : LPSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; OldFileSymbolPathArray : LPSTR* (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ExtendedOptionFlags : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; SymLoadCallback : PPATCH_SYMLOAD_CALLBACK (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; SymLoadContext : void* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; InterleaveMapArray : PATCH_INTERLEAVE_MAP** (+48, 8byte)  varptr(st)+48 を基点に操作(8byte:入れ子/配列)
; MaxLzxWindowSize : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PATCH_OPTION_DATA
    #field int SizeOfThisStruct
    #field int SymbolOptionFlags
    #field intptr NewFileSymbolPath
    #field intptr OldFileSymbolPathArray
    #field int ExtendedOptionFlags
    #field intptr SymLoadCallback
    #field intptr SymLoadContext
    #field intptr InterleaveMapArray
    #field int MaxLzxWindowSize
#endstruct

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