ホーム › System.Diagnostics.Etw › OpenTraceFromFile
OpenTraceFromFile
関数ETLログファイルからトレースを消費用に開く。
シグネチャ
// ADVAPI32.dll
#include <windows.h>
PROCESSTRACE_HANDLE OpenTraceFromFile(
LPCWSTR LogFileName,
const ETW_OPEN_TRACE_OPTIONS* Options,
TRACE_LOGFILE_HEADER* LogFileHeader // optional
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| LogFileName | LPCWSTR | in |
| Options | ETW_OPEN_TRACE_OPTIONS* | in |
| LogFileHeader | TRACE_LOGFILE_HEADER* | outoptional |
戻り値の型: PROCESSTRACE_HANDLE
各言語での呼び出し定義
// ADVAPI32.dll
#include <windows.h>
PROCESSTRACE_HANDLE OpenTraceFromFile(
LPCWSTR LogFileName,
const ETW_OPEN_TRACE_OPTIONS* Options,
TRACE_LOGFILE_HEADER* LogFileHeader // optional
);[DllImport("ADVAPI32.dll", ExactSpelling = true)]
static extern PROCESSTRACE_HANDLE OpenTraceFromFile(
[MarshalAs(UnmanagedType.LPWStr)] string LogFileName, // LPCWSTR
IntPtr Options, // ETW_OPEN_TRACE_OPTIONS*
IntPtr LogFileHeader // TRACE_LOGFILE_HEADER* optional, out
);<DllImport("ADVAPI32.dll", ExactSpelling:=True)>
Public Shared Function OpenTraceFromFile(
<MarshalAs(UnmanagedType.LPWStr)> LogFileName As String, ' LPCWSTR
Options As IntPtr, ' ETW_OPEN_TRACE_OPTIONS*
LogFileHeader As IntPtr ' TRACE_LOGFILE_HEADER* optional, out
) As PROCESSTRACE_HANDLE
End Function' LogFileName : LPCWSTR
' Options : ETW_OPEN_TRACE_OPTIONS*
' LogFileHeader : TRACE_LOGFILE_HEADER* optional, out
Declare PtrSafe Function OpenTraceFromFile Lib "advapi32" ( _
ByVal LogFileName As LongPtr, _
ByVal Options As LongPtr, _
ByVal LogFileHeader As LongPtr) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
OpenTraceFromFile = ctypes.windll.advapi32.OpenTraceFromFile
OpenTraceFromFile.restype = ctypes.c_void_p
OpenTraceFromFile.argtypes = [
wintypes.LPCWSTR, # LogFileName : LPCWSTR
ctypes.c_void_p, # Options : ETW_OPEN_TRACE_OPTIONS*
ctypes.c_void_p, # LogFileHeader : TRACE_LOGFILE_HEADER* optional, out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('ADVAPI32.dll')
OpenTraceFromFile = Fiddle::Function.new(
lib['OpenTraceFromFile'],
[
Fiddle::TYPE_VOIDP, # LogFileName : LPCWSTR
Fiddle::TYPE_VOIDP, # Options : ETW_OPEN_TRACE_OPTIONS*
Fiddle::TYPE_VOIDP, # LogFileHeader : TRACE_LOGFILE_HEADER* optional, out
],
Fiddle::TYPE_VOIDP)#[link(name = "advapi32")]
extern "system" {
fn OpenTraceFromFile(
LogFileName: *const u16, // LPCWSTR
Options: *const ETW_OPEN_TRACE_OPTIONS, // ETW_OPEN_TRACE_OPTIONS*
LogFileHeader: *mut TRACE_LOGFILE_HEADER // TRACE_LOGFILE_HEADER* optional, out
) -> PROCESSTRACE_HANDLE;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("ADVAPI32.dll")]
public static extern PROCESSTRACE_HANDLE OpenTraceFromFile([MarshalAs(UnmanagedType.LPWStr)] string LogFileName, IntPtr Options, IntPtr LogFileHeader);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_OpenTraceFromFile' -Namespace Win32 -PassThru
# $api::OpenTraceFromFile(LogFileName, Options, LogFileHeader)#uselib "ADVAPI32.dll"
#func global OpenTraceFromFile "OpenTraceFromFile" sptr, sptr, sptr
; OpenTraceFromFile LogFileName, varptr(Options), varptr(LogFileHeader) ; 戻り値は stat
; LogFileName : LPCWSTR -> "sptr"
; Options : ETW_OPEN_TRACE_OPTIONS* -> "sptr"
; LogFileHeader : TRACE_LOGFILE_HEADER* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "ADVAPI32.dll" #cfunc global OpenTraceFromFile "OpenTraceFromFile" wstr, var, var ; res = OpenTraceFromFile(LogFileName, Options, LogFileHeader) ; LogFileName : LPCWSTR -> "wstr" ; Options : ETW_OPEN_TRACE_OPTIONS* -> "var" ; LogFileHeader : TRACE_LOGFILE_HEADER* optional, out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "ADVAPI32.dll" #cfunc global OpenTraceFromFile "OpenTraceFromFile" wstr, sptr, sptr ; res = OpenTraceFromFile(LogFileName, varptr(Options), varptr(LogFileHeader)) ; LogFileName : LPCWSTR -> "wstr" ; Options : ETW_OPEN_TRACE_OPTIONS* -> "sptr" ; LogFileHeader : TRACE_LOGFILE_HEADER* optional, out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; PROCESSTRACE_HANDLE OpenTraceFromFile(LPCWSTR LogFileName, ETW_OPEN_TRACE_OPTIONS* Options, TRACE_LOGFILE_HEADER* LogFileHeader) #uselib "ADVAPI32.dll" #cfunc global OpenTraceFromFile "OpenTraceFromFile" wstr, var, var ; res = OpenTraceFromFile(LogFileName, Options, LogFileHeader) ; LogFileName : LPCWSTR -> "wstr" ; Options : ETW_OPEN_TRACE_OPTIONS* -> "var" ; LogFileHeader : TRACE_LOGFILE_HEADER* optional, out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; PROCESSTRACE_HANDLE OpenTraceFromFile(LPCWSTR LogFileName, ETW_OPEN_TRACE_OPTIONS* Options, TRACE_LOGFILE_HEADER* LogFileHeader) #uselib "ADVAPI32.dll" #cfunc global OpenTraceFromFile "OpenTraceFromFile" wstr, intptr, intptr ; res = OpenTraceFromFile(LogFileName, varptr(Options), varptr(LogFileHeader)) ; LogFileName : LPCWSTR -> "wstr" ; Options : ETW_OPEN_TRACE_OPTIONS* -> "intptr" ; LogFileHeader : TRACE_LOGFILE_HEADER* optional, out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
advapi32 = windows.NewLazySystemDLL("ADVAPI32.dll")
procOpenTraceFromFile = advapi32.NewProc("OpenTraceFromFile")
)
// LogFileName (LPCWSTR), Options (ETW_OPEN_TRACE_OPTIONS*), LogFileHeader (TRACE_LOGFILE_HEADER* optional, out)
r1, _, err := procOpenTraceFromFile.Call(
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(LogFileName))),
uintptr(Options),
uintptr(LogFileHeader),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // PROCESSTRACE_HANDLEfunction OpenTraceFromFile(
LogFileName: PWideChar; // LPCWSTR
Options: Pointer; // ETW_OPEN_TRACE_OPTIONS*
LogFileHeader: Pointer // TRACE_LOGFILE_HEADER* optional, out
): PROCESSTRACE_HANDLE; stdcall;
external 'ADVAPI32.dll' name 'OpenTraceFromFile';result := DllCall("ADVAPI32\OpenTraceFromFile"
, "WStr", LogFileName ; LPCWSTR
, "Ptr", Options ; ETW_OPEN_TRACE_OPTIONS*
, "Ptr", LogFileHeader ; TRACE_LOGFILE_HEADER* optional, out
, "Ptr") ; return: PROCESSTRACE_HANDLE●OpenTraceFromFile(LogFileName, Options, LogFileHeader) = DLL("ADVAPI32.dll", "void* OpenTraceFromFile(char*, void*, void*)")
# 呼び出し: OpenTraceFromFile(LogFileName, Options, LogFileHeader)
# LogFileName : LPCWSTR -> "char*"
# Options : ETW_OPEN_TRACE_OPTIONS* -> "void*"
# LogFileHeader : TRACE_LOGFILE_HEADER* optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。