estrutura DEBUG_EVENT (minwinbase.h)
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;
Membros
dwDebugEventCode
Tipo: DWORD
O código que identifica o tipo de evento de depuração. Esse membro pode ser um dos valores a seguir.
Valor | Significado |
---|---|
|
Relata um evento de depuração de processo de criação (inclui um processo e seu thread main). O valor de u.CreateProcessInfo especifica uma estrutura CREATE_PROCESS_DEBUG_INFO . |
|
Relata um evento de depuração create-thread (não inclui o thread main 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 EXCEPTION_DEBUG_INFO . |
|
Relata um evento de depuração de processo de saída. O valor de u.ExitProcess especifica uma estrutura 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 output-debugging-string. 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 unload-DLL. O valor de u.UnloadDll especifica uma estrutura 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 dwDebugEventCode for EXCEPTION_DEBUG_EVENT (1), u.Exception especificará uma estrutura EXCEPTION_DEBUG_INFO .
u.CreateThread
Tipo: CREATE_THREAD_DEBUG_INFO Se dwDebugEventCode for CREATE_THREAD_DEBUG_EVENT (2), u.CreateThread especificará uma estrutura CREATE_THREAD_DEBUG_INFO .
u.CreateProcessInfo
Tipo: CREATE_PROCESS_DEBUG_INFO Se dwDebugEventCode for CREATE_PROCESS_DEBUG_EVENT (3), u.CreateProcessInfo especificará uma estrutura CREATE_PROCESS_DEBUG_INFO .
u.ExitThread
Tipo: EXIT_THREAD_DEBUG_INFO Se dwDebugEventCode for EXIT_THREAD_DEBUG_EVENT (4), u.ExitThread especificará uma estrutura de EXIT_THREAD_DEBUG_INFO .
u.ExitProcess
Tipo: EXIT_PROCESS_DEBUG_INFO Se dwDebugEventCode for EXIT_PROCESS_DEBUG_EVENT (5), u.ExitProcess especificará uma estrutura de EXIT_PROCESS_DEBUG_INFO .
u.LoadDll
Tipo: LOAD_DLL_DEBUG_INFO Se dwDebugEventCode for LOAD_DLL_DEBUG_EVENT (6), u.LoadDll especificará uma estrutura LOAD_DLL_DEBUG_INFO .
u.UnloadDll
Tipo: UNLOAD_DLL_DEBUG_INFO Se dwDebugEventCode for UNLOAD_DLL_DEBUG_EVENT (7), u.UnloadDll especificará uma estrutura UNLOAD_DLL_DEBUG_INFO .
u.DebugString
Tipo: OUTPUT_DEBUG_STRING_INFO Se dwDebugEventCode for OUTPUT_DEBUG_STRING_EVENT (8), u.DebugString especificará uma estrutura OUTPUT_DEBUG_STRING_INFO .
u.RipInfo
Tipo: RIP_INFO Se dwDebugEventCode for RIP_EVENT (9), u.RipInfo especificará uma estrutura RIP_INFO .
Comentários
Se a função WaitForDebugEvent for bem-sucedida, ela preencherá os membros de uma estrutura DEBUG_EVENT .
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Cabeçalho | minwinbase.h (inclua Windows.h) |