Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |
|---|---|
|
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 . |
|
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 . |
|
Informa de un evento de depuración de excepciones. El valor de u.Exception especifica una estructura EXCEPTION_DEBUG_INFO . |
|
Informa de un evento de depuración de proceso de salida. El valor de u.ExitProcess especifica una estructura EXIT_PROCESS_DEBUG_INFO . |
|
Informa de un evento de depuración exit-thread. El valor de u.ExitThread especifica una estructura EXIT_THREAD_DEBUG_INFO . |
|
Informa de un evento de depuración load-dynamic-link-library (DLL). El valor de u.LoadDll especifica una estructura LOAD_DLL_DEBUG_INFO . |
|
Informa de un evento de depuración de cadena de salida. El valor de u.DebugString especifica una estructura OUTPUT_DEBUG_STRING_INFO . |
|
Informa de un evento rip-debugging (error de depuración del sistema). El valor de u.RipInfo especifica una estructura RIP_INFO . |
|
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) |