Compartir a través de


estructura DEBUG_EVENT (minwinbase.h)

Describe un evento de depuración.

Syntax

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

Código que identifica el tipo de evento de depuración. Este miembro puede ser uno de los siguientes valores.

Importancia Meaning
CREATE_PROCESS_DEBUG_EVENT
3
Informa de un evento de depuración de procesos de creación (incluye un proceso y su subproceso principal). El valor de u.CreateProcessInfo especifica una estructura CREATE_PROCESS_DEBUG_INFO .
CREATE_THREAD_DEBUG_EVENT
2
Informa de un evento de depuración de subprocesos de creación (no incluye el subproceso principal de un proceso, vea "CREATE_PROCESS_DEBUG_EVENT"). El valor de u.CreateThread especifica una estructura CREATE_THREAD_DEBUG_INFO .
EXCEPTION_DEBUG_EVENT
1
Informa de un evento de depuración de excepciones. El valor de u.Exception especifica una estructura EXCEPTION_DEBUG_INFO .
EXIT_PROCESS_DEBUG_EVENT
5
Informa de un evento de depuración de proceso de salida. El valor de u.ExitProcess especifica una estructura EXIT_PROCESS_DEBUG_INFO .
EXIT_THREAD_DEBUG_EVENT
4
Informa de un evento de depuración exit-thread. El valor de u.ExitThread especifica una estructura EXIT_THREAD_DEBUG_INFO .
LOAD_DLL_DEBUG_EVENT
6
Informa de un evento de depuración load-dynamic-link-library (DLL). El valor de u.LoadDll especifica una estructura LOAD_DLL_DEBUG_INFO .
OUTPUT_DEBUG_STRING_EVENT
8
Informa de un evento de depuración de cadena de salida. El valor de u.DebugString especifica una estructura OUTPUT_DEBUG_STRING_INFO .
RIP_EVENT
9
Informa de un evento rip-debugging (error de depuración del sistema). El valor de u.RipInfo especifica una estructura RIP_INFO .
UNLOAD_DLL_DEBUG_EVENT
7
Informa de un evento de depuración de unload-DLL. El valor de u.UnloadDll especifica una estructura UNLOAD_DLL_DEBUG_INFO .

dwProcessId

Tipo: DWORD

Identificador del proceso en el que se produjo el evento de depuración. Un depurador usa este valor para buscar la estructura por proceso del depurador. Estos valores no son necesariamente enteros pequeños que se pueden usar como índices de tabla.

dwThreadId

Tipo: DWORD

Identificador del subproceso en el que se produjo el evento de depuración. Un depurador usa este valor para buscar la estructura por subproceso del depurador. Estos valores no son necesariamente enteros pequeños que se pueden usar como índices de tabla.

u

Cualquier información adicional relacionada con el evento de depuración. Esta unión toma el tipo y el valor adecuados para el tipo de evento de depuración, como se describe en el miembro dwDebugEventCode .

u.Exception

Tipo: EXCEPTION_DEBUG_INFO

Si dwDebugEventCode es EXCEPTION_DEBUG_EVENT (1), u.Exception especifica una estructura EXCEPTION_DEBUG_INFO .

u.CreateThread

Tipo: CREATE_THREAD_DEBUG_INFO

Si dwDebugEventCode es CREATE_THREAD_DEBUG_EVENT (2), u.CreateThread especifica una estructura CREATE_THREAD_DEBUG_INFO .

u.CreateProcessInfo

Tipo: CREATE_PROCESS_DEBUG_INFO

Si dwDebugEventCode es CREATE_PROCESS_DEBUG_EVENT (3), u.CreateProcessInfo especifica una estructura de CREATE_PROCESS_DEBUG_INFO .

u.ExitThread

Tipo: EXIT_THREAD_DEBUG_INFO

Si dwDebugEventCode es EXIT_THREAD_DEBUG_EVENT (4), u.ExitThread especifica una estructura EXIT_THREAD_DEBUG_INFO .

u.ExitProcess

Tipo: EXIT_PROCESS_DEBUG_INFO

Si dwDebugEventCode es EXIT_PROCESS_DEBUG_EVENT (5), u.ExitProcess especifica una estructura EXIT_PROCESS_DEBUG_INFO .

u.LoadDll

Tipo: LOAD_DLL_DEBUG_INFO

Si dwDebugEventCode es LOAD_DLL_DEBUG_EVENT (6), u.LoadDll especifica una estructura LOAD_DLL_DEBUG_INFO .

u.UnloadDll

Tipo: UNLOAD_DLL_DEBUG_INFO

Si dwDebugEventCode es UNLOAD_DLL_DEBUG_EVENT (7), u.UnloadDll especifica una estructura UNLOAD_DLL_DEBUG_INFO .

u.DebugString

Tipo: OUTPUT_DEBUG_STRING_INFO

Si dwDebugEventCode es OUTPUT_DEBUG_STRING_EVENT (8), u.DebugString especifica una estructura de OUTPUT_DEBUG_STRING_INFO .

u.RipInfo

Tipo: RIP_INFO

Si dwDebugEventCode es RIP_EVENT (9), u.RipInfo especifica una estructura RIP_INFO .

Observaciones

Si la función WaitForDebugEvent se realiza correctamente, rellena los miembros de una estructura de DEBUG_EVENT .

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
Header minwinbase.h (incluya Windows.h)

Consulte también

CREATE_PROCESS_DEBUG_INFO

CREATE_THREAD_DEBUG_INFO

EXCEPTION_DEBUG_INFO

EXIT_PROCESS_DEBUG_INFO

EXIT_THREAD_DEBUG_INFO

LOAD_DLL_DEBUG_INFO

OUTPUT_DEBUG_STRING_INFO

UNLOAD_DLL_DEBUG_INFO

WaitForDebugEvent