ホーム › System.Threading › TP_CALLBACK_ENVIRON_V3
TP_CALLBACK_ENVIRON_V3
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| Version | DWORD | 4 | +0 | +0 | コールバック環境構造体のバージョン番号。 |
| Pool | PTP_POOL | 8/4 | +8 | +4 | コールバックを実行するスレッドプールへのポインタ(PTP_POOL)。 |
| CleanupGroup | PTP_CLEANUP_GROUP | 8/4 | +16 | +8 | クリーンアップグループへのポインタ。一括解放に使用する。 |
| CleanupGroupCancelCallback | PTP_CLEANUP_GROUP_CANCEL_CALLBACK | 8/4 | +24 | +12 | クリーンアップグループキャンセル時に呼ばれるコールバック関数。 |
| RaceDll | void* | 8/4 | +32 | +16 | アンロード競合を防ぐためのDLLモジュールハンドル。 |
| ActivationContext | INT_PTR | 8/4 | +40 | +20 | コールバックに関連付けるアクティベーションコンテキスト。 |
| FinalizationCallback | PTP_SIMPLE_CALLBACK | 8/4 | +48 | +24 | コールバック完了後に呼ばれる終了処理コールバック関数。 |
| u | _u_e__Union | 8/4 | +56 | +28 | フラグ等を格納する共用体。長時間実行や永続化の指定を含む。 |
| CallbackPriority | TP_CALLBACK_PRIORITY | 4 | +64 | +32 | コールバックの実行優先度(TP_CALLBACK_PRIORITY)。 |
| Size | DWORD | 4 | +68 | +36 | この構造体のサイズ(バイト)。 |
共用体: _u_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 |
|---|---|---|---|---|
| Flags | DWORD | 4 | +0 | +0 |
| s | _s_e__Struct | 8/4 | +0 | +0 |
各言語での定義
#include <windows.h>
// TP_CALLBACK_ENVIRON_V3 (x64 72 / x86 40 バイト)
typedef struct TP_CALLBACK_ENVIRON_V3 {
DWORD Version;
PTP_POOL Pool;
PTP_CLEANUP_GROUP CleanupGroup;
PTP_CLEANUP_GROUP_CANCEL_CALLBACK CleanupGroupCancelCallback;
void* RaceDll;
INT_PTR ActivationContext;
PTP_SIMPLE_CALLBACK FinalizationCallback;
_u_e__Union u;
TP_CALLBACK_PRIORITY CallbackPriority;
DWORD Size;
} TP_CALLBACK_ENVIRON_V3;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct TP_CALLBACK_ENVIRON_V3
{
public uint Version;
public IntPtr Pool;
public IntPtr CleanupGroup;
public IntPtr CleanupGroupCancelCallback;
public IntPtr RaceDll;
public IntPtr ActivationContext;
public IntPtr FinalizationCallback;
public _u_e__Union u;
public int CallbackPriority;
public uint Size;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure TP_CALLBACK_ENVIRON_V3
Public Version As UInteger
Public Pool As IntPtr
Public CleanupGroup As IntPtr
Public CleanupGroupCancelCallback As IntPtr
Public RaceDll As IntPtr
Public ActivationContext As IntPtr
Public FinalizationCallback As IntPtr
Public u As _u_e__Union
Public CallbackPriority As Integer
Public Size As UInteger
End Structureimport ctypes
from ctypes import wintypes
class TP_CALLBACK_ENVIRON_V3(ctypes.Structure):
_fields_ = [
("Version", wintypes.DWORD),
("Pool", ctypes.c_ssize_t),
("CleanupGroup", ctypes.c_ssize_t),
("CleanupGroupCancelCallback", ctypes.c_void_p),
("RaceDll", ctypes.c_void_p),
("ActivationContext", ctypes.c_ssize_t),
("FinalizationCallback", ctypes.c_void_p),
("u", _u_e__Union),
("CallbackPriority", ctypes.c_int),
("Size", wintypes.DWORD),
]#[repr(C)]
pub struct TP_CALLBACK_ENVIRON_V3 {
pub Version: u32,
pub Pool: isize,
pub CleanupGroup: isize,
pub CleanupGroupCancelCallback: *mut core::ffi::c_void,
pub RaceDll: *mut core::ffi::c_void,
pub ActivationContext: isize,
pub FinalizationCallback: *mut core::ffi::c_void,
pub u: _u_e__Union,
pub CallbackPriority: i32,
pub Size: u32,
}import "golang.org/x/sys/windows"
type TP_CALLBACK_ENVIRON_V3 struct {
Version uint32
Pool uintptr
CleanupGroup uintptr
CleanupGroupCancelCallback uintptr
RaceDll uintptr
ActivationContext uintptr
FinalizationCallback uintptr
u _u_e__Union
CallbackPriority int32
Size uint32
}type
TP_CALLBACK_ENVIRON_V3 = record
Version: DWORD;
Pool: NativeInt;
CleanupGroup: NativeInt;
CleanupGroupCancelCallback: Pointer;
RaceDll: Pointer;
ActivationContext: NativeInt;
FinalizationCallback: Pointer;
u: _u_e__Union;
CallbackPriority: Integer;
Size: DWORD;
end;const TP_CALLBACK_ENVIRON_V3 = extern struct {
Version: u32,
Pool: isize,
CleanupGroup: isize,
CleanupGroupCancelCallback: ?*anyopaque,
RaceDll: ?*anyopaque,
ActivationContext: isize,
FinalizationCallback: ?*anyopaque,
u: _u_e__Union,
CallbackPriority: i32,
Size: u32,
};type
TP_CALLBACK_ENVIRON_V3 {.bycopy.} = object
Version: uint32
Pool: int
CleanupGroup: int
CleanupGroupCancelCallback: pointer
RaceDll: pointer
ActivationContext: int
FinalizationCallback: pointer
u: _u_e__Union
CallbackPriority: int32
Size: uint32struct TP_CALLBACK_ENVIRON_V3
{
uint Version;
ptrdiff_t Pool;
ptrdiff_t CleanupGroup;
void* CleanupGroupCancelCallback;
void* RaceDll;
ptrdiff_t ActivationContext;
void* FinalizationCallback;
_u_e__Union u;
int CallbackPriority;
uint Size;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; TP_CALLBACK_ENVIRON_V3 サイズ: 40 バイト(x86)
dim st, 10 ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; Version : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Pool : PTP_POOL (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; CleanupGroup : PTP_CLEANUP_GROUP (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; CleanupGroupCancelCallback : PTP_CLEANUP_GROUP_CANCEL_CALLBACK (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; RaceDll : void* (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ActivationContext : INT_PTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; FinalizationCallback : PTP_SIMPLE_CALLBACK (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; u : _u_e__Union (+28, 4byte) varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; CallbackPriority : TP_CALLBACK_PRIORITY (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; Size : DWORD (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; TP_CALLBACK_ENVIRON_V3 サイズ: 72 バイト(x64)
dim st, 18 ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; Version : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Pool : PTP_POOL (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; CleanupGroup : PTP_CLEANUP_GROUP (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; CleanupGroupCancelCallback : PTP_CLEANUP_GROUP_CANCEL_CALLBACK (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; RaceDll : void* (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ActivationContext : INT_PTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; FinalizationCallback : PTP_SIMPLE_CALLBACK (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; u : _u_e__Union (+56, 8byte) varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; CallbackPriority : TP_CALLBACK_PRIORITY (+64, 4byte) st.16 = 値 / 値 = st.16 (lpoke/lpeek も可)
; Size : DWORD (+68, 4byte) st.17 = 値 / 値 = st.17 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global TP_CALLBACK_ENVIRON_V3
#field int Version
#field intptr Pool
#field intptr CleanupGroup
#field intptr CleanupGroupCancelCallback
#field intptr RaceDll
#field intptr ActivationContext
#field intptr FinalizationCallback
#field byte u 8
#field int CallbackPriority
#field int Size
#endstruct
stdim st, TP_CALLBACK_ENVIRON_V3 ; NSTRUCT 変数を確保
st->Version = 100
mes "Version=" + st->Version
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。