DEBUG_EVENT

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This structure describes a debugging event.

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;

Members

dwDebugEventCode

Specifies a debugging event code that identifies the type of debugging event. It is one of the following values:

Value	Description
EXCEPTION_DEBUG_EVENT	Reports an exception debugging event. The value of u.Exceptionspecifies an EXCEPTION_DEBUG_INFOstructure.
CREATE_THREAD_DEBUG_EVENT	Reports a create-thread debugging event. The value of u.CreateThreadspecifies a CREATE_THREAD_DEBUG_INFOstructure.
CREATE_PROCESS_DEBUG_EVENT	Reports a create-process debugging event. The value of u.CreateProcessInfospecifies a CREATE_PROCESS_DEBUG_INFOstructure.
EXIT_THREAD_DEBUG_EVENT	Reports an exit-thread debugging event. The value of u.ExitThreadspecifies an EXIT_THREAD_DEBUG_INFOstructure.
EXIT_PROCESS_DEBUG_EVENT	Reports an exit-process debugging event. The value of u.ExitProcessspecifies an EXIT_PROCESS_DEBUG_INFOstructure.
LOAD_DLL_DEBUG_EVENT	Reports a load-dynamic-link-library (DLL) debugging event. The value of u.LoadDllspecifies a LOAD_DLL_DEBUG_INFOstructure.
UNLOAD_DLL_DEBUG_EVENT	Reports an unload-DLL debugging event. The value of u.UnloadDllspecifies an UNLOAD_DLL_DEBUG_INFOstructure.
OUTPUT_DEBUG_STRING_EVENT	Reports an output-debugging-string debugging event. The value of u.DebugStringspecifies an OUTPUT_DEBUG_STRING_INFOstructure.

dwProcessId

Specifies the identifier of the process in which the debugging event occurred. A debugger uses this value to locate the debugger's per-process structure. These values are not necessarily small integers that can be used as table indices.

dwThreadId

Specifies the identifier of the thread in which the debugging event occurred. A debugger uses this value to locate the debugger's per-thread structure. These values are not necessarily small integers that can be used as table indices.

u

Specifies additional information relating to the debugging event. This union takes on the type and value appropriate to the type of debugging event, as described in the dwDebugEventCodemember.

Remarks

If the WaitForDebugEventfunction succeeds, it fills in the members of a DEBUG_EVENTstructure.

Requirements

Runs On	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Winbase.h

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.