ホーム › System.Diagnostics.Debug › InitializeContext2
InitializeContext2
関数XStateの圧縮マスクを指定して、スレッドコンテキスト構造体をバッファ内に初期化する。
シグネチャ
// KERNEL32.dll
#include <windows.h>
BOOL InitializeContext2(
void* Buffer, // optional
CONTEXT_FLAGS ContextFlags,
CONTEXT** Context,
DWORD* ContextLength,
ULONGLONG XStateCompactionMask
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| Buffer | void* | outoptional |
| ContextFlags | CONTEXT_FLAGS | in |
| Context | CONTEXT** | out |
| ContextLength | DWORD* | inout |
| XStateCompactionMask | ULONGLONG | in |
戻り値の型: BOOL
各言語での呼び出し定義
// KERNEL32.dll
#include <windows.h>
BOOL InitializeContext2(
void* Buffer, // optional
CONTEXT_FLAGS ContextFlags,
CONTEXT** Context,
DWORD* ContextLength,
ULONGLONG XStateCompactionMask
);[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("KERNEL32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool InitializeContext2(
IntPtr Buffer, // void* optional, out
uint ContextFlags, // CONTEXT_FLAGS
IntPtr Context, // CONTEXT** out
ref uint ContextLength, // DWORD* in/out
ulong XStateCompactionMask // ULONGLONG
);<DllImport("KERNEL32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function InitializeContext2(
Buffer As IntPtr, ' void* optional, out
ContextFlags As UInteger, ' CONTEXT_FLAGS
Context As IntPtr, ' CONTEXT** out
ByRef ContextLength As UInteger, ' DWORD* in/out
XStateCompactionMask As ULong ' ULONGLONG
) As Boolean
End Function' Buffer : void* optional, out
' ContextFlags : CONTEXT_FLAGS
' Context : CONTEXT** out
' ContextLength : DWORD* in/out
' XStateCompactionMask : ULONGLONG
Declare PtrSafe Function InitializeContext2 Lib "kernel32" ( _
ByVal Buffer As LongPtr, _
ByVal ContextFlags As Long, _
ByVal Context As LongPtr, _
ByRef ContextLength As Long, _
ByVal XStateCompactionMask As LongLong) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
InitializeContext2 = ctypes.windll.kernel32.InitializeContext2
InitializeContext2.restype = wintypes.BOOL
InitializeContext2.argtypes = [
ctypes.POINTER(None), # Buffer : void* optional, out
wintypes.DWORD, # ContextFlags : CONTEXT_FLAGS
ctypes.c_void_p, # Context : CONTEXT** out
ctypes.POINTER(wintypes.DWORD), # ContextLength : DWORD* in/out
ctypes.c_ulonglong, # XStateCompactionMask : ULONGLONG
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('KERNEL32.dll')
InitializeContext2 = Fiddle::Function.new(
lib['InitializeContext2'],
[
Fiddle::TYPE_VOIDP, # Buffer : void* optional, out
-Fiddle::TYPE_INT, # ContextFlags : CONTEXT_FLAGS
Fiddle::TYPE_VOIDP, # Context : CONTEXT** out
Fiddle::TYPE_VOIDP, # ContextLength : DWORD* in/out
-Fiddle::TYPE_LONG_LONG, # XStateCompactionMask : ULONGLONG
],
Fiddle::TYPE_INT)#[link(name = "kernel32")]
extern "system" {
fn InitializeContext2(
Buffer: *mut (), // void* optional, out
ContextFlags: u32, // CONTEXT_FLAGS
Context: *mut *mut CONTEXT, // CONTEXT** out
ContextLength: *mut u32, // DWORD* in/out
XStateCompactionMask: u64 // ULONGLONG
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("KERNEL32.dll", SetLastError = true)]
public static extern bool InitializeContext2(IntPtr Buffer, uint ContextFlags, IntPtr Context, ref uint ContextLength, ulong XStateCompactionMask);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_InitializeContext2' -Namespace Win32 -PassThru
# $api::InitializeContext2(Buffer, ContextFlags, Context, ContextLength, XStateCompactionMask)#uselib "KERNEL32.dll"
#func global InitializeContext2 "InitializeContext2" sptr, sptr, sptr, sptr, sptr
; InitializeContext2 Buffer, ContextFlags, varptr(Context), varptr(ContextLength), XStateCompactionMask ; 戻り値は stat
; Buffer : void* optional, out -> "sptr"
; ContextFlags : CONTEXT_FLAGS -> "sptr"
; Context : CONTEXT** out -> "sptr"
; ContextLength : DWORD* in/out -> "sptr"
; XStateCompactionMask : ULONGLONG -> "sptr"
; ※HSP3.7は int64 引数(64bit値渡し)に非対応です。
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "KERNEL32.dll" #cfunc global InitializeContext2 "InitializeContext2" sptr, int, var, var, int64 ; res = InitializeContext2(Buffer, ContextFlags, Context, ContextLength, XStateCompactionMask) ; Buffer : void* optional, out -> "sptr" ; ContextFlags : CONTEXT_FLAGS -> "int" ; Context : CONTEXT** out -> "var" ; ContextLength : DWORD* in/out -> "var" ; XStateCompactionMask : ULONGLONG -> "int64" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。 ; ※int64 引数の DLL 値渡しは x64 ランタイム(hsp3_64)のみ対応(x86 は未対応)。#uselib "KERNEL32.dll" #cfunc global InitializeContext2 "InitializeContext2" sptr, int, sptr, sptr, int64 ; res = InitializeContext2(Buffer, ContextFlags, varptr(Context), varptr(ContextLength), XStateCompactionMask) ; Buffer : void* optional, out -> "sptr" ; ContextFlags : CONTEXT_FLAGS -> "int" ; Context : CONTEXT** out -> "sptr" ; ContextLength : DWORD* in/out -> "sptr" ; XStateCompactionMask : ULONGLONG -> "int64" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※int64 引数の DLL 値渡しは x64 ランタイム(hsp3_64)のみ対応(x86 は未対応)。
出力引数:
; BOOL InitializeContext2(void* Buffer, CONTEXT_FLAGS ContextFlags, CONTEXT** Context, DWORD* ContextLength, ULONGLONG XStateCompactionMask) #uselib "KERNEL32.dll" #cfunc global InitializeContext2 "InitializeContext2" intptr, int, var, var, int64 ; res = InitializeContext2(Buffer, ContextFlags, Context, ContextLength, XStateCompactionMask) ; Buffer : void* optional, out -> "intptr" ; ContextFlags : CONTEXT_FLAGS -> "int" ; Context : CONTEXT** out -> "var" ; ContextLength : DWORD* in/out -> "var" ; XStateCompactionMask : ULONGLONG -> "int64" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL InitializeContext2(void* Buffer, CONTEXT_FLAGS ContextFlags, CONTEXT** Context, DWORD* ContextLength, ULONGLONG XStateCompactionMask) #uselib "KERNEL32.dll" #cfunc global InitializeContext2 "InitializeContext2" intptr, int, intptr, intptr, int64 ; res = InitializeContext2(Buffer, ContextFlags, varptr(Context), varptr(ContextLength), XStateCompactionMask) ; Buffer : void* optional, out -> "intptr" ; ContextFlags : CONTEXT_FLAGS -> "int" ; Context : CONTEXT** out -> "intptr" ; ContextLength : DWORD* in/out -> "intptr" ; XStateCompactionMask : ULONGLONG -> "int64" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
kernel32 = windows.NewLazySystemDLL("KERNEL32.dll")
procInitializeContext2 = kernel32.NewProc("InitializeContext2")
)
// Buffer (void* optional, out), ContextFlags (CONTEXT_FLAGS), Context (CONTEXT** out), ContextLength (DWORD* in/out), XStateCompactionMask (ULONGLONG)
r1, _, err := procInitializeContext2.Call(
uintptr(Buffer),
uintptr(ContextFlags),
uintptr(Context),
uintptr(ContextLength),
uintptr(XStateCompactionMask),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // BOOLfunction InitializeContext2(
Buffer: Pointer; // void* optional, out
ContextFlags: DWORD; // CONTEXT_FLAGS
Context: Pointer; // CONTEXT** out
ContextLength: Pointer; // DWORD* in/out
XStateCompactionMask: UInt64 // ULONGLONG
): BOOL; stdcall;
external 'KERNEL32.dll' name 'InitializeContext2';result := DllCall("KERNEL32\InitializeContext2"
, "Ptr", Buffer ; void* optional, out
, "UInt", ContextFlags ; CONTEXT_FLAGS
, "Ptr", Context ; CONTEXT** out
, "Ptr", ContextLength ; DWORD* in/out
, "Int64", XStateCompactionMask ; ULONGLONG
, "Int") ; return: BOOL●InitializeContext2(Buffer, ContextFlags, Context, ContextLength, XStateCompactionMask) = DLL("KERNEL32.dll", "bool InitializeContext2(void*, dword, void*, void*, qword)")
# 呼び出し: InitializeContext2(Buffer, ContextFlags, Context, ContextLength, XStateCompactionMask)
# Buffer : void* optional, out -> "void*"
# ContextFlags : CONTEXT_FLAGS -> "dword"
# Context : CONTEXT** out -> "void*"
# ContextLength : DWORD* in/out -> "void*"
# XStateCompactionMask : ULONGLONG -> "qword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。