estructura DEBUG_EVENT (minwinbase.h)

Artículo
03/05/2024

Describe un evento de depuración.

Sintaxis

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;

Miembros

dwDebugEventCode

Tipo: DWORD

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

Valor	Significado
CREATE_PROCESS_DEBUG_EVENT 3	Notifica un evento de depuración de proceso 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 creación de subprocesos (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	Notifica un evento de depuración de excepciones. El valor de u.Exception especifica una estructura de EXCEPTION_DEBUG_INFO .
EXIT_PROCESS_DEBUG_EVENT 5	Notifica 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 de EXIT_THREAD_DEBUG_INFO .
LOAD_DLL_DEBUG_EVENT 6	Notifica 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	Notifica 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 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 de EXCEPTION_DEBUG_INFO .

u.CreateThread

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

u.CreateProcessInfo

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

u.ExitThread

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

u.ExitProcess

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

u.LoadDll

Tipo: LOAD_DLL_DEBUG_INFO Si dwDebugEventCode es LOAD_DLL_DEBUG_EVENT (6), u.LoadDll especifica una estructura de 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 OUTPUT_DEBUG_STRING_INFO .

u.RipInfo

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

Comentarios

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	minwinbase.h (incluye Windows.h)