structure DEBUG_EVENT (minwinbase.h)

Article
08/24/2023

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;

Membres

dwDebugEventCode

Type : DWORD

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

Valeur	Signification
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 main). 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 main 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 DLL (load-dynamic-link-library). 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 de DLL de déchargement. 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 pour le 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 le 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 le 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 le 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 le dwDebugEventCode est OUTPUT_DEBUG_STRING_EVENT (8), u.DebugString spécifie une structure OUTPUT_DEBUG_STRING_INFO .

u.RipInfo

Type : RIP_INFO Si le 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 .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	minwinbase.h (inclure Windows.h)