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

WER_DUMP_CUSTOM_OPTIONS

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 552 バイト / x86: 552 バイト

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

フィールド

フィールド型サイズx64x86説明
dwSizeDWORD4+0+0構造体のサイズ (バイト単位)。
dwMaskDWORD4+4+4

この構造体内のどのオプションが有効であるかを制御するマスクです。次の値のうち 1 つ以上を指定できます:

  • WER_DUMP_MASK_DUMPTYPE
  • WER_DUMP_MASK_ONLY_THISTHREAD
  • WER_DUMP_MASK_OTHER_MODULESFLAGS
  • WER_DUMP_MASK_OTHERTHREADFLAGS
  • WER_DUMP_MASK_OTHERTHREADFLAGS_EX
  • WER_DUMP_MASK_PREFERRED_MODULE_LIST
  • WER_DUMP_MASK_PREFERRED_MODULESFLAGS
  • WER_DUMP_MASK_THREADFLAGS
  • WER_DUMP_MASK_THREADFLAGS_EX
dwDumpFlagsDWORD4+8+8

ミニダンプに含める情報の種類です。MINIDUMP_TYPE フラグのうち 1 つ以上を指定できます。

このメンバーは、dwMask に WER_DUMP_MASK_DUMPTYPE が含まれる場合にのみ有効です。

bOnlyThisThreadBOOL4+12+12このメンバーが TRUE で、かつ dwMask に WER_DUMP_MASK_ONLY_THISTHREAD が含まれる場合、ミニダンプは呼び出し元スレッドについてのみ収集されます。
dwExceptionThreadFlagsDWORD4+16+16

ミニダンプに含めるスレッド情報の種類です。THREAD_WRITE_FLAGS フラグのうち 1 つ以上を指定できます。

このメンバーは、dwMask に WER_DUMP_MASK_THREADFLAGS が含まれる場合にのみ有効です。

dwOtherThreadFlagsDWORD4+20+20

ミニダンプに含めるスレッド情報の種類です。THREAD_WRITE_FLAGS フラグのうち 1 つ以上を指定できます。

このメンバーは、dwMask に WER_DUMP_MASK_OTHERTHREADFLAGS が含まれる場合にのみ有効です。

dwExceptionThreadExFlagsDWORD4+24+24

ミニダンプに含めるスレッド情報の種類です。THREAD_WRITE_FLAGS フラグのうち 1 つ以上を指定できます。

このメンバーは、dwMask に WER_DUMP_MASK_THREADFLAGS_EX が含まれる場合にのみ有効です。

dwOtherThreadExFlagsDWORD4+28+28

ミニダンプに含めるスレッド情報の種類です。THREAD_WRITE_FLAGS フラグのうち 1 つ以上を指定できます。

このメンバーは、dwMask に WER_DUMP_MASK_OTHERTHREADFLAGS_EX が含まれる場合にのみ有効です。

dwPreferredModuleFlagsDWORD4+32+32

wzPreferredModuleList メンバーで指定されたモジュールについて、ミニダンプに含めるモジュール情報の種類です。MODULE_WRITE_FLAGS フラグのうち 1 つ以上を指定できます。

このメンバーは、dwMask に WER_DUMP_MASK_PREFERRED_MODULESFLAGS が含まれる場合にのみ有効です。

dwOtherModuleFlagsDWORD4+36+36

ミニダンプに含めるモジュール情報の種類です。MODULE_WRITE_FLAGS フラグのうち 1 つ以上を指定できます。

このメンバーは、dwMask に WER_DUMP_MASK_OTHER_MODULESFLAGS が含まれる場合にのみ有効です。

wzPreferredModuleListWCHAR512+40+40

dwPreferredModuleFlags フラグを適用するモジュール名 (パスは含めません) のリストです。各名前は null で終端し、リスト全体は 2 つの null 文字で終端しなければなりません (例: module1.dll\0module2.dll\0\0)。

すべてのモジュールを優先対象として指定するには、このメンバーに *\0\0 を設定します。他のモジュール名を含むリストに * を含めた場合、* は無視されます。

このメンバーは、dwMask に WER_DUMP_MASK_PREFERRED_MODULE_LIST が含まれる場合にのみ有効です。

公式ドキュメント

Windows エラー報告 (WER) のミニダンプ情報のうち、WerReportAddDump 関数によって収集されるカスタム情報を指定します。

解説(Remarks)

この構造体で指定するフラグは、WER がダンプファイルを生成するときに MINIDUMP_CALLBACK_ROUTINE コールバック関数 (MiniDumpWriteDump 関数 を参照) に渡されるフラグと直接対応しています。

ミニダンプのコールバック入力の種類が ThreadCallback の場合 (MINIDUMP_CALLBACK_INPUT 構造体 の CallbackType メンバーを参照)、MINIDUMP_CALLBACK_OUTPUT 構造体 の ThreadWriteFlags メンバーには、dwExceptionThreadFlags、dwExceptionThreadExFlags、dwOtherThreadFlags、または dwOtherThreadExFlags の各メンバーで指定したフラグが設定されます。コールバックがクラッシュしたスレッドに対するものである場合は dwExceptionThreadFlags または dwExceptionThreadExFlags のフラグが使用され、それ以外の場合は dwOtherThreadFlags または dwOtherThreadExFlags のフラグが使用されます。

コールバック入力の種類が ModuleCallback の場合、MINIDUMP_CALLBACK_OUTPUT 構造体 の ModuleWriteFlags メンバーには、dwPreferredModuleFlags または dwOtherModuleFlags の各メンバーで指定したフラグが設定されます。コールバックが優先モジュール一覧に含まれるモジュールに対するものである場合は dwPreferredModuleFlags のフラグが使用され、それ以外の場合は dwOtherModuleFlags のフラグが使用されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// WER_DUMP_CUSTOM_OPTIONS  (x64 552 / x86 552 バイト)
typedef struct WER_DUMP_CUSTOM_OPTIONS {
    DWORD dwSize;
    DWORD dwMask;
    DWORD dwDumpFlags;
    BOOL bOnlyThisThread;
    DWORD dwExceptionThreadFlags;
    DWORD dwOtherThreadFlags;
    DWORD dwExceptionThreadExFlags;
    DWORD dwOtherThreadExFlags;
    DWORD dwPreferredModuleFlags;
    DWORD dwOtherModuleFlags;
    WCHAR wzPreferredModuleList[256];
} WER_DUMP_CUSTOM_OPTIONS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WER_DUMP_CUSTOM_OPTIONS
{
    public uint dwSize;
    public uint dwMask;
    public uint dwDumpFlags;
    [MarshalAs(UnmanagedType.Bool)] public bool bOnlyThisThread;
    public uint dwExceptionThreadFlags;
    public uint dwOtherThreadFlags;
    public uint dwExceptionThreadExFlags;
    public uint dwOtherThreadExFlags;
    public uint dwPreferredModuleFlags;
    public uint dwOtherModuleFlags;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string wzPreferredModuleList;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WER_DUMP_CUSTOM_OPTIONS
    Public dwSize As UInteger
    Public dwMask As UInteger
    Public dwDumpFlags As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public bOnlyThisThread As Boolean
    Public dwExceptionThreadFlags As UInteger
    Public dwOtherThreadFlags As UInteger
    Public dwExceptionThreadExFlags As UInteger
    Public dwOtherThreadExFlags As UInteger
    Public dwPreferredModuleFlags As UInteger
    Public dwOtherModuleFlags As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=256)> Public wzPreferredModuleList As String
End Structure
import ctypes
from ctypes import wintypes

class WER_DUMP_CUSTOM_OPTIONS(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwMask", wintypes.DWORD),
        ("dwDumpFlags", wintypes.DWORD),
        ("bOnlyThisThread", wintypes.BOOL),
        ("dwExceptionThreadFlags", wintypes.DWORD),
        ("dwOtherThreadFlags", wintypes.DWORD),
        ("dwExceptionThreadExFlags", wintypes.DWORD),
        ("dwOtherThreadExFlags", wintypes.DWORD),
        ("dwPreferredModuleFlags", wintypes.DWORD),
        ("dwOtherModuleFlags", wintypes.DWORD),
        ("wzPreferredModuleList", ctypes.c_wchar * 256),
    ]
#[repr(C)]
pub struct WER_DUMP_CUSTOM_OPTIONS {
    pub dwSize: u32,
    pub dwMask: u32,
    pub dwDumpFlags: u32,
    pub bOnlyThisThread: i32,
    pub dwExceptionThreadFlags: u32,
    pub dwOtherThreadFlags: u32,
    pub dwExceptionThreadExFlags: u32,
    pub dwOtherThreadExFlags: u32,
    pub dwPreferredModuleFlags: u32,
    pub dwOtherModuleFlags: u32,
    pub wzPreferredModuleList: [u16; 256],
}
import "golang.org/x/sys/windows"

type WER_DUMP_CUSTOM_OPTIONS struct {
	dwSize uint32
	dwMask uint32
	dwDumpFlags uint32
	bOnlyThisThread int32
	dwExceptionThreadFlags uint32
	dwOtherThreadFlags uint32
	dwExceptionThreadExFlags uint32
	dwOtherThreadExFlags uint32
	dwPreferredModuleFlags uint32
	dwOtherModuleFlags uint32
	wzPreferredModuleList [256]uint16
}
type
  WER_DUMP_CUSTOM_OPTIONS = record
    dwSize: DWORD;
    dwMask: DWORD;
    dwDumpFlags: DWORD;
    bOnlyThisThread: BOOL;
    dwExceptionThreadFlags: DWORD;
    dwOtherThreadFlags: DWORD;
    dwExceptionThreadExFlags: DWORD;
    dwOtherThreadExFlags: DWORD;
    dwPreferredModuleFlags: DWORD;
    dwOtherModuleFlags: DWORD;
    wzPreferredModuleList: array[0..255] of WideChar;
  end;
const WER_DUMP_CUSTOM_OPTIONS = extern struct {
    dwSize: u32,
    dwMask: u32,
    dwDumpFlags: u32,
    bOnlyThisThread: i32,
    dwExceptionThreadFlags: u32,
    dwOtherThreadFlags: u32,
    dwExceptionThreadExFlags: u32,
    dwOtherThreadExFlags: u32,
    dwPreferredModuleFlags: u32,
    dwOtherModuleFlags: u32,
    wzPreferredModuleList: [256]u16,
};
type
  WER_DUMP_CUSTOM_OPTIONS {.bycopy.} = object
    dwSize: uint32
    dwMask: uint32
    dwDumpFlags: uint32
    bOnlyThisThread: int32
    dwExceptionThreadFlags: uint32
    dwOtherThreadFlags: uint32
    dwExceptionThreadExFlags: uint32
    dwOtherThreadExFlags: uint32
    dwPreferredModuleFlags: uint32
    dwOtherModuleFlags: uint32
    wzPreferredModuleList: array[256, uint16]
struct WER_DUMP_CUSTOM_OPTIONS
{
    uint dwSize;
    uint dwMask;
    uint dwDumpFlags;
    int bOnlyThisThread;
    uint dwExceptionThreadFlags;
    uint dwOtherThreadFlags;
    uint dwExceptionThreadExFlags;
    uint dwOtherThreadExFlags;
    uint dwPreferredModuleFlags;
    uint dwOtherModuleFlags;
    wchar[256] wzPreferredModuleList;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WER_DUMP_CUSTOM_OPTIONS サイズ: 552 バイト(x64)
dim st, 138    ; 4byte整数×138(構造体サイズ 552 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwMask : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwDumpFlags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; bOnlyThisThread : BOOL (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwExceptionThreadFlags : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwOtherThreadFlags : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwExceptionThreadExFlags : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwOtherThreadExFlags : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwPreferredModuleFlags : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwOtherModuleFlags : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; wzPreferredModuleList : WCHAR (+40, 512byte)  varptr(st)+40 を基点に操作(512byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WER_DUMP_CUSTOM_OPTIONS
    #field int dwSize
    #field int dwMask
    #field int dwDumpFlags
    #field bool bOnlyThisThread
    #field int dwExceptionThreadFlags
    #field int dwOtherThreadFlags
    #field int dwExceptionThreadExFlags
    #field int dwOtherThreadExFlags
    #field int dwPreferredModuleFlags
    #field int dwOtherModuleFlags
    #field wchar wzPreferredModuleList 256
#endstruct

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