Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Описывает событие отладки.
Синтаксис
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;
Members
dwDebugEventCode
Тип: DWORD
Код, определяющий тип события отладки. Этот элемент может быть одним из следующих значений.
| Ценность | Meaning |
|---|---|
|
Сообщает о событии отладки процесса создания (включает как процесс, так и основной поток). Значение u.CreateProcessInfo указывает структуру CREATE_PROCESS_DEBUG_INFO . |
|
Сообщает о событии отладки создания потока (не включает основной поток процесса, см. раздел "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
Если 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
Если dwDebugEventCodeимеет значение EXIT_THREAD_DEBUG_EVENT (4), u.ExitThread указывает структуру EXIT_THREAD_DEBUG_INFO .
u.ExitProcess
Если 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
Если dwDebugEventCodeимеет значение UNLOAD_DLL_DEBUG_EVENT (7), u.UnloadDll указывает структуру UNLOAD_DLL_DEBUG_INFO .
u.DebugString
Если dwDebugEventCodeимеет значение OUTPUT_DEBUG_STRING_EVENT (8), u.DebugString указывает структуру OUTPUT_DEBUG_STRING_INFO .
u.RipInfo
Тип: RIP_INFO
Если dwDebugEventCodeRIP_EVENT (9), u.RipInfo указывает структуру RIP_INFO .
Замечания
Если функция WaitForDebugEvent успешно выполнена, она заполняет элементы структуры DEBUG_EVENT .
Требования
| Требование | Ценность |
|---|---|
| Минимальный поддерживаемый клиент | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| Header | minwinbase.h (включая Windows.h) |