Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Descreve um evento de depuração.
Sintaxe
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
Tipo: DWORD
O código que identifica o tipo de evento de depuração. Esse membro pode ser um dos seguintes valores.
| Value | Meaning |
|---|---|
|
Relata um evento de depuração de processo de criação (inclui um processo e seu thread principal). O valor de u.CreateProcessInfo especifica uma estrutura CREATE_PROCESS_DEBUG_INFO . |
|
Relata um evento de depuração de create-thread (não inclui o thread principal de um processo, consulte 'CREATE_PROCESS_DEBUG_EVENT'). O valor de u.CreateThread especifica uma estrutura CREATE_THREAD_DEBUG_INFO . |
|
Relata um evento de depuração de exceção. O valor de u.Exception especifica uma estrutura de EXCEPTION_DEBUG_INFO . |
|
Relata um evento de depuração de processo de saída. O valor de u.ExitProcess especifica uma estrutura de EXIT_PROCESS_DEBUG_INFO . |
|
Relata um evento de depuração de thread de saída. O valor de u.ExitThread especifica uma estrutura EXIT_THREAD_DEBUG_INFO . |
|
Relata um evento de depuração de DLL (load-dynamic-link-library). O valor de u.LoadDll especifica uma estrutura LOAD_DLL_DEBUG_INFO . |
|
Relata um evento de depuração de cadeia de caracteres de saída-depuração. O valor de u.DebugString especifica uma estrutura OUTPUT_DEBUG_STRING_INFO . |
|
Relata um evento de depuração rip (erro de depuração do sistema). O valor de u.RipInfo especifica uma estrutura RIP_INFO . |
|
Relata um evento de depuração de DLL de descarregamento. O valor de u.UnloadDll especifica uma estrutura de UNLOAD_DLL_DEBUG_INFO . |
dwProcessId
Tipo: DWORD
O identificador do processo no qual o evento de depuração ocorreu. Um depurador usa esse valor para localizar a estrutura por processo do depurador. Esses valores não são necessariamente números inteiros pequenos que podem ser usados como índices de tabela.
dwThreadId
Tipo: DWORD
O identificador do thread no qual o evento de depuração ocorreu. Um depurador usa esse valor para localizar a estrutura por thread do depurador. Esses valores não são necessariamente números inteiros pequenos que podem ser usados como índices de tabela.
u
Qualquer informação adicional relacionada ao evento de depuração. Essa união assume o tipo e o valor apropriados para o tipo de evento de depuração, conforme descrito no membro dwDebugEventCode .
u.Exception
Tipo: EXCEPTION_DEBUG_INFO
Se o dwDebugEventCode for EXCEPTION_DEBUG_EVENT (1), a u.Exception especifica uma estrutura de EXCEPTION_DEBUG_INFO .
u.CreateThread
Tipo: CREATE_THREAD_DEBUG_INFO
Se o dwDebugEventCode for CREATE_THREAD_DEBUG_EVENT (2), u.CreateThread especifica uma estrutura de CREATE_THREAD_DEBUG_INFO .
u.CreateProcessInfo
Tipo: CREATE_PROCESS_DEBUG_INFO
Se o dwDebugEventCode for CREATE_PROCESS_DEBUG_EVENT (3), u.CreateProcessInfo especifica uma estrutura CREATE_PROCESS_DEBUG_INFO .
u.ExitThread
Tipo: EXIT_THREAD_DEBUG_INFO
Se o dwDebugEventCode for EXIT_THREAD_DEBUG_EVENT (4), u.ExitThread especifica uma estrutura de EXIT_THREAD_DEBUG_INFO .
u.ExitProcess
Tipo: EXIT_PROCESS_DEBUG_INFO
Se o dwDebugEventCode for EXIT_PROCESS_DEBUG_EVENT (5), o u.ExitProcess especifica uma estrutura de EXIT_PROCESS_DEBUG_INFO .
u.LoadDll
Tipo: LOAD_DLL_DEBUG_INFO
Se o dwDebugEventCode for LOAD_DLL_DEBUG_EVENT (6), u.LoadDll especifica uma estrutura de LOAD_DLL_DEBUG_INFO .
u.UnloadDll
Tipo: UNLOAD_DLL_DEBUG_INFO
Se o dwDebugEventCode for UNLOAD_DLL_DEBUG_EVENT (7), u.UnloadDll especifica uma estrutura de UNLOAD_DLL_DEBUG_INFO .
u.DebugString
Tipo: OUTPUT_DEBUG_STRING_INFO
Se o dwDebugEventCode for OUTPUT_DEBUG_STRING_EVENT (8), u.DebugString especifica uma estrutura OUTPUT_DEBUG_STRING_INFO .
u.RipInfo
Tipo: RIP_INFO
Se o dwDebugEventCode for RIP_EVENT (9), o u.RipInfo especifica uma estrutura de RIP_INFO .
Observações
Se a função WaitForDebugEvent for bem-sucedida, ela preencherá os membros de uma estrutura DEBUG_EVENT .
Requirements
| Requirement | Value |
|---|---|
| Cliente mínimo suportado | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo compatível | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Header | minwinbase.h (inclua Windows.h) |