DEBUG_EVENT-Struktur (minwinbase.h)
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 |
|---|---|
|
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. |
|
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. |
|
Meldet ein Ausnahmedebuggenereignis. Der Wert von u.Exception gibt eine EXCEPTION_DEBUG_INFO-Struktur an. |
|
Meldet ein Debugereignis für den Exitprozess. Der Wert von u.ExitProcess gibt eine EXIT_PROCESS_DEBUG_INFO-Struktur an. |
|
Meldet ein Debugereignis für den Exitthread. Der Wert von u.ExitThread gibt eine EXIT_THREAD_DEBUG_INFO-Struktur an. |
|
Meldet ein DLL-Debugereignis (load-dynamic-link-library). Der Wert von u.LoadDll gibt eine LOAD_DLL_DEBUG_INFO-Struktur an. |
|
Meldet ein Debugereignis vom Typ output-debugging-string. Der Wert von u.DebugString gibt eine OUTPUT_DEBUG_STRING_INFO-Struktur an. |
|
Meldet ein RIP-Debugereignis (Systemdebugfehler). Der Wert von u.RipInfo gibt eine RIP_INFO-Struktur an. |
|
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) |