структура DEBUG_EVENT (minwinbase.h)
Описывает событие отладки.
Синтаксис
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
Код, определяющий тип события отладки. Этот элемент может иметь одно из следующих значений.
Значение | Значение |
---|---|
|
Сообщает о событии отладки процесса создания (включает как процесс, так и его поток main). Значение u.CreateProcessInfo указывает структуру CREATE_PROCESS_DEBUG_INFO . |
|
Сообщает о событии отладки потока создания (не включает main поток процесса, см. раздел CREATE_PROCESS_DEBUG_EVENT). Значение u.CreateThread указывает структуру CREATE_THREAD_DEBUG_INFO . |
|
Сообщает о событии отладки исключений. Значение u.Exception указывает структуру EXCEPTION_DEBUG_INFO . |
|
Сообщает о событии отладки процесса выхода. Значение u.ExitProcess указывает структуру EXIT_PROCESS_DEBUG_INFO . |
|
Сообщает о событии отладки потока выхода. Значение u.ExitThread указывает структуру EXIT_THREAD_DEBUG_INFO . |
|
Сообщает о событии отладки load-dynamic-link-library (DLL). Значение u.LoadDll указывает структуру LOAD_DLL_DEBUG_INFO . |
|
Сообщает о событии отладки строки вывода. Значение u.DebugString указывает структуру OUTPUT_DEBUG_STRING_INFO . |
|
Сообщает о событии отладки RIP (системная ошибка отладки). Значение u.RipInfo указывает структуру RIP_INFO . |
|
Сообщает о событии отладки 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 .
Комментарии
Если функция WaitForDebugEvent завершается успешно, она заполняет элементы структуры DEBUG_EVENT .
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Верхняя часть | minwinbase.h (включая Windows.h) |