Partager via


structure DEBUG_EVENT (minwinbase.h)

Décrit un événement de débogage.

Syntaxe

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

Type : DWORD

Code qui identifie le type d’événement de débogage. Ce membre peut être l’une des valeurs suivantes.

Valeur Meaning
CREATE_PROCESS_DEBUG_EVENT
3
Signale un événement de débogage de processus de création (inclut à la fois un processus et son thread principal). La valeur de u.CreateProcessInfo spécifie une structure CREATE_PROCESS_DEBUG_INFO .
CREATE_THREAD_DEBUG_EVENT
2
Signale un événement de débogage create-thread (n’inclut pas le thread principal d’un processus, consultez « CREATE_PROCESS_DEBUG_EVENT »). La valeur de u.CreateThread spécifie une structure CREATE_THREAD_DEBUG_INFO .
EXCEPTION_DEBUG_EVENT
1
Signale un événement de débogage d’exception. La valeur de u.Exception spécifie une structure EXCEPTION_DEBUG_INFO .
EXIT_PROCESS_DEBUG_EVENT
5
Signale un événement de débogage de processus de sortie. La valeur de u.ExitProcess spécifie une structure EXIT_PROCESS_DEBUG_INFO .
EXIT_THREAD_DEBUG_EVENT
4
Signale un événement de débogage de thread de sortie. La valeur de u.ExitThread spécifie une structure EXIT_THREAD_DEBUG_INFO .
LOAD_DLL_DEBUG_EVENT
6
Signale un événement de débogage load-dynamic-link-library (DLL). La valeur de u.LoadDll spécifie une structure LOAD_DLL_DEBUG_INFO .
OUTPUT_DEBUG_STRING_EVENT
8
Signale un événement de débogage de chaîne de sortie. La valeur de u.DebugString spécifie une structure OUTPUT_DEBUG_STRING_INFO .
RIP_EVENT
9
Signale un événement de débogage RIP (erreur de débogage système). La valeur de u.RipInfo spécifie une structure RIP_INFO .
UNLOAD_DLL_DEBUG_EVENT
7
Signale un événement de débogage unload-DLL. La valeur de u.UnloadDll spécifie une structure UNLOAD_DLL_DEBUG_INFO .

dwProcessId

Type : DWORD

Identificateur du processus dans lequel l’événement de débogage s’est produit. Un débogueur utilise cette valeur pour localiser la structure par processus du débogueur. Ces valeurs ne sont pas nécessairement de petits entiers qui peuvent être utilisés comme index de table.

dwThreadId

Type : DWORD

Identificateur du thread dans lequel l’événement de débogage s’est produit. Un débogueur utilise cette valeur pour localiser la structure par thread du débogueur. Ces valeurs ne sont pas nécessairement de petits entiers qui peuvent être utilisés comme index de table.

u

Toutes les informations supplémentaires relatives à l’événement de débogage. Cette union prend le type et la valeur appropriés au type d’événement de débogage, comme décrit dans le membre dwDebugEventCode .

u.Exception

Type : EXCEPTION_DEBUG_INFO

Si dwDebugEventCode est EXCEPTION_DEBUG_EVENT (1), u.Exception spécifie une structure EXCEPTION_DEBUG_INFO .

u.CreateThread

Type : CREATE_THREAD_DEBUG_INFO

Si dwDebugEventCode est CREATE_THREAD_DEBUG_EVENT (2), u.CreateThread spécifie une structure CREATE_THREAD_DEBUG_INFO .

u.CreateProcessInfo

Type : CREATE_PROCESS_DEBUG_INFO

Si dwDebugEventCode est CREATE_PROCESS_DEBUG_EVENT (3), u.CreateProcessInfo spécifie une structure CREATE_PROCESS_DEBUG_INFO .

u.ExitThread

Type : EXIT_THREAD_DEBUG_INFO

Si dwDebugEventCode est EXIT_THREAD_DEBUG_EVENT (4), u.ExitThread spécifie une structure EXIT_THREAD_DEBUG_INFO .

u.ExitProcess

Type : EXIT_PROCESS_DEBUG_INFO

Si dwDebugEventCode est EXIT_PROCESS_DEBUG_EVENT (5), u.ExitProcess spécifie une structure EXIT_PROCESS_DEBUG_INFO .

u.LoadDll

Type : LOAD_DLL_DEBUG_INFO

Si dwDebugEventCode est LOAD_DLL_DEBUG_EVENT (6), u.LoadDll spécifie une structure LOAD_DLL_DEBUG_INFO .

u.UnloadDll

Type : UNLOAD_DLL_DEBUG_INFO

Si dwDebugEventCode est UNLOAD_DLL_DEBUG_EVENT (7), u.UnloadDll spécifie une structure UNLOAD_DLL_DEBUG_INFO .

u.DebugString

Type : OUTPUT_DEBUG_STRING_INFO

Si dwDebugEventCode est OUTPUT_DEBUG_STRING_EVENT (8), u.DebugString spécifie une structure OUTPUT_DEBUG_STRING_INFO .

u.RipInfo

Type : RIP_INFO

Si dwDebugEventCode est RIP_EVENT (9), u.RipInfo spécifie une structure RIP_INFO .

Remarques

Si la fonction WaitForDebugEvent réussit, elle remplit les membres d’une structure DEBUG_EVENT .

Spécifications

Requirement Valeur
Client minimum requis Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Header minwinbase.h (include Windows.h)

Voir aussi

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