Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
|---|---|
|
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 . |
|
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 . |
|
Signale un événement de débogage d’exception. La valeur de u.Exception spécifie une structure EXCEPTION_DEBUG_INFO . |
|
Signale un événement de débogage de processus de sortie. La valeur de u.ExitProcess spécifie une structure EXIT_PROCESS_DEBUG_INFO . |
|
Signale un événement de débogage de thread de sortie. La valeur de u.ExitThread spécifie une structure EXIT_THREAD_DEBUG_INFO . |
|
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 . |
|
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 . |
|
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 . |
|
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) |