структура DEBUG_EVENT (minwinbase.h)

Статья
08/24/2023

Описывает событие отладки.

Синтаксис

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;

Члены

dwDebugEventCode

Тип: DWORD

Код, определяющий тип события отладки. Этот элемент может иметь одно из следующих значений.

Значение	Значение
CREATE_PROCESS_DEBUG_EVENT 3	Сообщает о событии отладки процесса создания (включает как процесс, так и его поток main). Значение u.CreateProcessInfo указывает структуру CREATE_PROCESS_DEBUG_INFO .
CREATE_THREAD_DEBUG_EVENT 2	Сообщает о событии отладки потока создания (не включает main поток процесса, см. раздел CREATE_PROCESS_DEBUG_EVENT). Значение u.CreateThread указывает структуру CREATE_THREAD_DEBUG_INFO .
EXCEPTION_DEBUG_EVENT 1	Сообщает о событии отладки исключений. Значение u.Exception указывает структуру EXCEPTION_DEBUG_INFO .
EXIT_PROCESS_DEBUG_EVENT 5	Сообщает о событии отладки процесса выхода. Значение u.ExitProcess указывает структуру EXIT_PROCESS_DEBUG_INFO .
EXIT_THREAD_DEBUG_EVENT 4	Сообщает о событии отладки потока выхода. Значение u.ExitThread указывает структуру EXIT_THREAD_DEBUG_INFO .
LOAD_DLL_DEBUG_EVENT 6	Сообщает о событии отладки load-dynamic-link-library (DLL). Значение u.LoadDll указывает структуру LOAD_DLL_DEBUG_INFO .
OUTPUT_DEBUG_STRING_EVENT 8	Сообщает о событии отладки строки вывода. Значение u.DebugString указывает структуру OUTPUT_DEBUG_STRING_INFO .
RIP_EVENT 9	Сообщает о событии отладки RIP (системная ошибка отладки). Значение u.RipInfo указывает структуру RIP_INFO .
UNLOAD_DLL_DEBUG_EVENT 7	Сообщает о событии отладки dll-выгрузки. Значение u.UnloadDll указывает структуру UNLOAD_DLL_DEBUG_INFO .

dwProcessId

Тип: DWORD

Идентификатор процесса, в котором произошло событие отладки. Отладчик использует это значение для поиска структуры каждого процесса отладчика. Эти значения не обязательно являются небольшими целыми числами, которые можно использовать в качестве табличных индексов.

dwThreadId

Тип: DWORD

Идентификатор потока, в котором произошло событие отладки. Отладчик использует это значение для поиска структуры отладчика для каждого потока. Эти значения не обязательно являются небольшими целыми числами, которые можно использовать в качестве табличных индексов.

u

Любые дополнительные сведения, относящиеся к событию отладки. Это объединение принимает тип и значение, соответствующие типу события отладки, как описано в элементе dwDebugEventCode .

u.Exception

Тип: EXCEPTION_DEBUG_INFO Если dwDebugEventCode имеет значение EXCEPTION_DEBUG_EVENT (1), u.Exception указывает EXCEPTION_DEBUG_INFO структуру.

u.CreateThread

Тип: CREATE_THREAD_DEBUG_INFO Если dwDebugEventCode имеет значение CREATE_THREAD_DEBUG_EVENT (2), u.CreateThread указывает структуру CREATE_THREAD_DEBUG_INFO .

u.CreateProcessInfo

Тип: CREATE_PROCESS_DEBUG_INFO Если dwDebugEventCode имеет значение CREATE_PROCESS_DEBUG_EVENT (3), u.CreateProcessInfo указывает структуру CREATE_PROCESS_DEBUG_INFO .

u.ExitThread

Тип: EXIT_THREAD_DEBUG_INFO Если dwDebugEventCode имеет значение EXIT_THREAD_DEBUG_EVENT (4), u.ExitThread указывает структуру EXIT_THREAD_DEBUG_INFO .

u.ExitProcess

Тип: EXIT_PROCESS_DEBUG_INFO Если dwDebugEventCode имеет значение EXIT_PROCESS_DEBUG_EVENT (5), u.ExitProcess задает EXIT_PROCESS_DEBUG_INFO структуру.

u.LoadDll

Тип: LOAD_DLL_DEBUG_INFO Если dwDebugEventCode имеет значение LOAD_DLL_DEBUG_EVENT (6), u.LoadDll задает структуру LOAD_DLL_DEBUG_INFO .

u.UnloadDll

Тип: UNLOAD_DLL_DEBUG_INFO Если dwDebugEventCode имеет значение UNLOAD_DLL_DEBUG_EVENT (7), u.UnloadDll указывает структуру UNLOAD_DLL_DEBUG_INFO .

u.DebugString

Тип: OUTPUT_DEBUG_STRING_INFO Если dwDebugEventCode имеет значение OUTPUT_DEBUG_STRING_EVENT (8), u.DebugString задает структуру OUTPUT_DEBUG_STRING_INFO .

u.RipInfo

Тип: RIP_INFO Если dwDebugEventCode имеет значение RIP_EVENT (9), u.RipInfo указывает структуру RIP_INFO .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	minwinbase.h (включая Windows.h)