Win32 API 日本語リファレンス
ホーム › System.Diagnostics.Debug › MINIDUMP_EXCEPTION

MINIDUMP_EXCEPTION

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 152 バイト / x86: 152 バイトパッキング4

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

フィールド

フィールド型サイズx64x86説明
ExceptionCodeDWORD4+0+0

例外が発生した理由です。これはハードウェア例外によって生成されたコード、またはソフトウェアで生成された例外の場合は RaiseException 関数で指定されたコードです。一般的なプログラミングエラーによって発生しやすい例外コードを次に示します。

値 意味
EXCEPTION_ACCESS_VIOLATION
 スレッドが、適切なアクセス権を持たない仮想アドレスに対して読み取りまたは書き込みを試みました。
EXCEPTION_ARRAY_BOUNDS_EXCEEDED
 スレッドが範囲外の配列要素にアクセスしようとし、基盤となるハードウェアが境界チェックをサポートしています。
EXCEPTION_BREAKPOINT
 ブレークポイントが検出されました。
EXCEPTION_DATATYPE_MISALIGNMENT
 スレッドが、アライメントを提供しないハードウェア上で、アライメントの合っていないデータの読み取りまたは書き込みを試みました。たとえば、16 ビット値は 2 バイト境界に、32 ビット値は 4 バイト境界にアライメントされている必要があります。
EXCEPTION_FLT_DENORMAL_OPERAND
 浮動小数点演算のオペランドの 1 つが非正規化数です。非正規化数とは、標準的な浮動小数点値として表現するには小さすぎる値です。
EXCEPTION_FLT_DIVIDE_BY_ZERO
 スレッドが浮動小数点値を除数 0 の浮動小数点数で除算しようとしました。
EXCEPTION_FLT_INEXACT_RESULT
 浮動小数点演算の結果を、10 進小数として正確に表現できません。
EXCEPTION_FLT_INVALID_OPERATION
 この例外は、このリストに含まれていないすべての浮動小数点例外を表します。
EXCEPTION_FLT_OVERFLOW
 浮動小数点演算の指数部が、対応する型で許容される大きさを超えています。
EXCEPTION_FLT_STACK_CHECK
 浮動小数点演算の結果として、スタックがオーバーフローまたはアンダーフローしました。
EXCEPTION_FLT_UNDERFLOW
 浮動小数点演算の指数部が、対応する型で許容される大きさを下回っています。
EXCEPTION_ILLEGAL_INSTRUCTION
 スレッドが無効な命令を実行しようとしました。
EXCEPTION_IN_PAGE_ERROR
 スレッドが存在しないページにアクセスしようとしましたが、システムはそのページを読み込めませんでした。たとえば、ネットワーク経由でプログラムを実行しているときにネットワーク接続が失われた場合に、この例外が発生することがあります。
EXCEPTION_INT_DIVIDE_BY_ZERO
 スレッドが整数値を除数 0 の整数で除算しようとしました。
EXCEPTION_INT_OVERFLOW
 整数演算の結果、結果の最上位ビットからの桁上がりが発生しました。
EXCEPTION_INVALID_DISPOSITION
 例外ハンドラーが例外ディスパッチャーに無効な処理結果 (disposition) を返しました。C などの高水準言語を使用するプログラマーがこの例外に遭遇することはありません。
EXCEPTION_NONCONTINUABLE_EXCEPTION
 継続不可能な例外が発生した後に、スレッドが実行を継続しようとしました。
EXCEPTION_PRIV_INSTRUCTION
 スレッドが、現在のマシンモードでは許可されていない操作を行う命令を実行しようとしました。
EXCEPTION_SINGLE_STEP
 トレーストラップまたはその他の単一命令実行機構が、1 つの命令が実行されたことを通知しました。
EXCEPTION_STACK_OVERFLOW
 スレッドがスタックを使い果たしました。

コンソールプロセスをデバッグしているときに発生しやすい例外コードが、もう 1 つあります。これはプログラミングエラーが原因で発生するものではありません。DBG_CONTROL_C 例外コードは、CTRL+C シグナルを処理し、かつデバッグ対象となっているコンソールプロセスに CTRL+C が入力されたときに発生します。この例外コードは、アプリケーションが処理することを意図したものではありません。これはデバッガーのためだけに発生し、デバッガーがコンソールプロセスにアタッチされている場合にのみ発生します。

ExceptionFlagsDWORD4+4+4このメンバーは、継続可能な例外を示す 0 か、継続不可能な例外を示す EXCEPTION_NONCONTINUABLE のいずれかになります。継続不可能な例外の発生後に実行を継続しようとすると、EXCEPTION_NONCONTINUABLE_EXCEPTION 例外が発生します。
ExceptionRecordULONGLONG8+8+8関連付けられた MINIDUMP_EXCEPTION 構造体へのポインターです。例外レコードは連結することができ、入れ子になった例外が発生した場合に追加情報を提供できます。
ExceptionAddressULONGLONG8+16+16例外が発生したアドレスです。
NumberParametersDWORD4+24+24例外に関連付けられたパラメーターの数です。これは ExceptionInformation 配列内で定義されている要素の数です。
__unusedAlignmentDWORD4+28+28アラインメント用の未使用パディング。
ExceptionInformationULONGLONG120+32+32

例外を説明する追加の引数の配列です。 RaiseException 関数では、この引数の配列を指定できます。ほとんどの例外コードでは、配列の要素は未定義です。次の例外コードでは、配列の要素は以下のように定義されます。

例外コード 意味
EXCEPTION_ACCESS_VIOLATION
 配列の最初の要素には、アクセス違反を引き起こした操作の種類を示す読み取り/書き込みフラグが格納されます。この値が 0 の場合、スレッドはアクセスできないデータの読み取りを試みました。この値が 1 の場合、スレッドはアクセスできないアドレスへの書き込みを試みました。

2 番目の配列要素は、アクセスできないデータの仮想アドレスを指定します。

公式ドキュメント

例外情報を格納します。

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

各言語での定義

#include <windows.h>

// MINIDUMP_EXCEPTION  (x64 152 / x86 152 バイト)
#pragma pack(push, 4)
typedef struct MINIDUMP_EXCEPTION {
    DWORD ExceptionCode;
    DWORD ExceptionFlags;
    ULONGLONG ExceptionRecord;
    ULONGLONG ExceptionAddress;
    DWORD NumberParameters;
    DWORD __unusedAlignment;
    ULONGLONG ExceptionInformation[15];
} MINIDUMP_EXCEPTION;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 4, CharSet = CharSet.Unicode)]
public struct MINIDUMP_EXCEPTION
{
    public uint ExceptionCode;
    public uint ExceptionFlags;
    public ulong ExceptionRecord;
    public ulong ExceptionAddress;
    public uint NumberParameters;
    public uint __unusedAlignment;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 15)] public ulong[] ExceptionInformation;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=4, CharSet:=CharSet.Unicode)>
Public Structure MINIDUMP_EXCEPTION
    Public ExceptionCode As UInteger
    Public ExceptionFlags As UInteger
    Public ExceptionRecord As ULong
    Public ExceptionAddress As ULong
    Public NumberParameters As UInteger
    Public __unusedAlignment As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=15)> Public ExceptionInformation() As ULong
End Structure
import ctypes
from ctypes import wintypes

class MINIDUMP_EXCEPTION(ctypes.Structure):
    _pack_ = 4
    _fields_ = [
        ("ExceptionCode", wintypes.DWORD),
        ("ExceptionFlags", wintypes.DWORD),
        ("ExceptionRecord", ctypes.c_ulonglong),
        ("ExceptionAddress", ctypes.c_ulonglong),
        ("NumberParameters", wintypes.DWORD),
        ("__unusedAlignment", wintypes.DWORD),
        ("ExceptionInformation", ctypes.c_ulonglong * 15),
    ]
#[repr(C, packed(4))]
pub struct MINIDUMP_EXCEPTION {
    pub ExceptionCode: u32,
    pub ExceptionFlags: u32,
    pub ExceptionRecord: u64,
    pub ExceptionAddress: u64,
    pub NumberParameters: u32,
    pub __unusedAlignment: u32,
    pub ExceptionInformation: [u64; 15],
}
import "golang.org/x/sys/windows"

type MINIDUMP_EXCEPTION struct {
	ExceptionCode uint32
	ExceptionFlags uint32
	ExceptionRecord uint64
	ExceptionAddress uint64
	NumberParameters uint32
	__unusedAlignment uint32
	ExceptionInformation [15]uint64
}
type
  MINIDUMP_EXCEPTION = packed record
    ExceptionCode: DWORD;
    ExceptionFlags: DWORD;
    ExceptionRecord: UInt64;
    ExceptionAddress: UInt64;
    NumberParameters: DWORD;
    __unusedAlignment: DWORD;
    ExceptionInformation: array[0..14] of UInt64;
  end;
const MINIDUMP_EXCEPTION = extern struct {
    ExceptionCode: u32,
    ExceptionFlags: u32,
    ExceptionRecord: u64,
    ExceptionAddress: u64,
    NumberParameters: u32,
    __unusedAlignment: u32,
    ExceptionInformation: [15]u64,
};
type
  MINIDUMP_EXCEPTION {.packed.} = object
    ExceptionCode: uint32
    ExceptionFlags: uint32
    ExceptionRecord: uint64
    ExceptionAddress: uint64
    NumberParameters: uint32
    __unusedAlignment: uint32
    ExceptionInformation: array[15, uint64]
align(4)
struct MINIDUMP_EXCEPTION
{
    uint ExceptionCode;
    uint ExceptionFlags;
    ulong ExceptionRecord;
    ulong ExceptionAddress;
    uint NumberParameters;
    uint __unusedAlignment;
    ulong[15] ExceptionInformation;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MINIDUMP_EXCEPTION サイズ: 152 バイト(x64)
dim st, 38    ; 4byte整数×38(構造体サイズ 152 / 4 切り上げ)
; ExceptionCode : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ExceptionFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ExceptionRecord : ULONGLONG (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; ExceptionAddress : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; NumberParameters : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; __unusedAlignment : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ExceptionInformation : ULONGLONG (+32, 120byte)  varptr(st)+32 を基点に操作(120byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MINIDUMP_EXCEPTION, pack=4
    #field int ExceptionCode
    #field int ExceptionFlags
    #field int64 ExceptionRecord
    #field int64 ExceptionAddress
    #field int NumberParameters
    #field int __unusedAlignment
    #field int64 ExceptionInformation 15
#endstruct

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