DEBUG_EVENT-Struktur (minwinbase.h)

Artikel
02/29/2024

Beschreibt ein Debugereignis.

Syntax

typedef struct _DEBUG_EVENT {
  DWORD dwDebugEventCode;
  DWORD dwProcessId;
  DWORD dwThreadId;
  union {
    EXCEPTION_DEBUG_INFO      Exception;
    CREATE_THREAD_DEBUG_INFO  CreateThread;
    CREATE_PROCESS_DEBUG_INFO CreateProcessInfo;
    EXIT_THREAD_DEBUG_INFO    ExitThread;
    EXIT_PROCESS_DEBUG_INFO   ExitProcess;
    LOAD_DLL_DEBUG_INFO       LoadDll;
    UNLOAD_DLL_DEBUG_INFO     UnloadDll;
    OUTPUT_DEBUG_STRING_INFO  DebugString;
    RIP_INFO                  RipInfo;
  } u;
} DEBUG_EVENT, *LPDEBUG_EVENT;

Member

dwDebugEventCode

Art: DWORD

Der Code, der den Typ des Debugereignisses identifiziert. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
CREATE_PROCESS_DEBUG_EVENT 3	Meldet ein Debugereignis zum Erstellen eines Prozesses (umfasst sowohl einen Prozess als auch seinen Standard Thread). Der Wert von u.CreateProcessInfo gibt eine CREATE_PROCESS_DEBUG_INFO-Struktur an.
CREATE_THREAD_DEBUG_EVENT 2	Meldet ein Create-Thread-Debugereignis (enthält nicht den Standard Thread eines Prozesses, siehe "CREATE_PROCESS_DEBUG_EVENT"). Der Wert von u.CreateThread gibt eine CREATE_THREAD_DEBUG_INFO-Struktur an.
EXCEPTION_DEBUG_EVENT 1	Meldet ein Ausnahmedebuggenereignis. Der Wert von u.Exception gibt eine EXCEPTION_DEBUG_INFO-Struktur an.
EXIT_PROCESS_DEBUG_EVENT 5	Meldet ein Debugereignis für den Exitprozess. Der Wert von u.ExitProcess gibt eine EXIT_PROCESS_DEBUG_INFO-Struktur an.
EXIT_THREAD_DEBUG_EVENT 4	Meldet ein Debugereignis für den Exitthread. Der Wert von u.ExitThread gibt eine EXIT_THREAD_DEBUG_INFO-Struktur an.
LOAD_DLL_DEBUG_EVENT 6	Meldet ein DLL-Debugereignis (load-dynamic-link-library). Der Wert von u.LoadDll gibt eine LOAD_DLL_DEBUG_INFO-Struktur an.
OUTPUT_DEBUG_STRING_EVENT 8	Meldet ein Debugereignis vom Typ output-debugging-string. Der Wert von u.DebugString gibt eine OUTPUT_DEBUG_STRING_INFO-Struktur an.
RIP_EVENT 9	Meldet ein RIP-Debugereignis (Systemdebugfehler). Der Wert von u.RipInfo gibt eine RIP_INFO-Struktur an.
UNLOAD_DLL_DEBUG_EVENT 7	Meldet ein Deload-DLL-Debugereignis. Der Wert von u.UnloadDll gibt eine UNLOAD_DLL_DEBUG_INFO-Struktur an.

dwProcessId

Art: DWORD

Der Bezeichner des Prozesses, in dem das Debugereignis aufgetreten ist. Ein Debugger verwendet diesen Wert, um die Prozessstruktur des Debuggers zu suchen. Diese Werte sind nicht unbedingt kleine ganze Zahlen, die als Tabellenindizes verwendet werden können.

dwThreadId

Art: DWORD

Der Bezeichner des Threads, in dem das Debugereignis aufgetreten ist. Ein Debugger verwendet diesen Wert, um die Threadstruktur des Debuggers zu suchen. Diese Werte sind nicht unbedingt kleine ganze Zahlen, die als Tabellenindizes verwendet werden können.

u

Alle zusätzlichen Informationen im Zusammenhang mit dem Debugereignis. Diese Union übernimmt den Typ und wert, der für den Typ des Debugereignisses geeignet ist, wie im dwDebugEventCode-Element beschrieben.

u.Exception

Typ: EXCEPTION_DEBUG_INFO Wenn dwDebugEventCodeEXCEPTION_DEBUG_EVENT (1) ist, gibt u.Exception eine EXCEPTION_DEBUG_INFO-Struktur an.

u.CreateThread

Typ: CREATE_THREAD_DEBUG_INFO Wenn dwDebugEventCodeCREATE_THREAD_DEBUG_EVENT (2) ist, gibt u.CreateThread eine CREATE_THREAD_DEBUG_INFO-Struktur an.

u.CreateProcessInfo

Typ: CREATE_PROCESS_DEBUG_INFO Wenn dwDebugEventCodeCREATE_PROCESS_DEBUG_EVENT (3) ist, gibt u.CreateProcessInfo eine CREATE_PROCESS_DEBUG_INFO-Struktur an.

u.ExitThread

Typ: EXIT_THREAD_DEBUG_INFO Wenn dwDebugEventCodeEXIT_THREAD_DEBUG_EVENT (4) ist, gibt u.ExitThread eine EXIT_THREAD_DEBUG_INFO-Struktur an.

u.ExitProcess

Typ: EXIT_PROCESS_DEBUG_INFO Wenn dwDebugEventCodeEXIT_PROCESS_DEBUG_EVENT (5) ist, gibt u.ExitProcess eine EXIT_PROCESS_DEBUG_INFO-Struktur an.

u.LoadDll

Typ: LOAD_DLL_DEBUG_INFO Wenn dwDebugEventCodeLOAD_DLL_DEBUG_EVENT (6) ist, gibt u.LoadDll eine LOAD_DLL_DEBUG_INFO-Struktur an.

u.UnloadDll

Typ: UNLOAD_DLL_DEBUG_INFO Wenn dwDebugEventCodeUNLOAD_DLL_DEBUG_EVENT (7) ist, gibt u.UnloadDll eine UNLOAD_DLL_DEBUG_INFO-Struktur an.

u.DebugString

Typ: OUTPUT_DEBUG_STRING_INFO Wenn dwDebugEventCodeOUTPUT_DEBUG_STRING_EVENT (8) ist, gibt u.DebugString eine OUTPUT_DEBUG_STRING_INFO-Struktur an.

u.RipInfo

Typ: RIP_INFO Wenn dwDebugEventCodeRIP_EVENT (9) ist, gibt u.RipInfo eine RIP_INFO-Struktur an.

Hinweise

Wenn die WaitForDebugEvent-Funktion erfolgreich ist, füllt sie die Member einer DEBUG_EVENT-Struktur aus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	minwinbase.h (windows.h einschließen)