Поделиться через


структура 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

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

Значение Значение
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 .

Комментарии

Если функция WaitForDebugEvent завершается успешно, она заполняет элементы структуры DEBUG_EVENT .

Требования

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

См. также раздел

CREATE_PROCESS_DEBUG_INFO

CREATE_THREAD_DEBUG_INFO

EXCEPTION_DEBUG_INFO

EXIT_PROCESS_DEBUG_INFO

EXIT_THREAD_DEBUG_INFO

LOAD_DLL_DEBUG_INFO

OUTPUT_DEBUG_STRING_INFO

UNLOAD_DLL_DEBUG_INFO

WaitForDebugEvent