estrutura DEBUG_EVENT (minwinbase.h)

Artigo
08/24/2023

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
CREATE_PROCESS_DEBUG_EVENT 3	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 .
CREATE_THREAD_DEBUG_EVENT 2	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 .
EXCEPTION_DEBUG_EVENT 1	Relata um evento de depuração de exceção. O valor de u.Exception especifica uma estrutura EXCEPTION_DEBUG_INFO .
EXIT_PROCESS_DEBUG_EVENT 5	Relata um evento de depuração de processo de saída. O valor de u.ExitProcess especifica uma estrutura EXIT_PROCESS_DEBUG_INFO .
EXIT_THREAD_DEBUG_EVENT 4	Relata um evento de depuração de thread de saída. O valor de u.ExitThread especifica uma estrutura EXIT_THREAD_DEBUG_INFO .
LOAD_DLL_DEBUG_EVENT 6	Relata um evento de depuração de DLL (load-dynamic-link-library). O valor de u.LoadDll especifica uma estrutura LOAD_DLL_DEBUG_INFO .
OUTPUT_DEBUG_STRING_EVENT 8	Relata um evento de depuração output-debugging-string. O valor de u.DebugString especifica uma estrutura OUTPUT_DEBUG_STRING_INFO .
RIP_EVENT 9	Relata um evento de depuração RIP (erro de depuração do sistema). O valor de u.RipInfo especifica uma estrutura RIP_INFO .
UNLOAD_DLL_DEBUG_EVENT 7	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)