DEBUG_EVENT struttura (minwinbase.h)

Articolo
08/24/2023

Descrive un evento di debug.

Sintassi

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

Codice che identifica il tipo di evento di debug. Questo membro può essere uno dei valori seguenti.

Valore	Significato
CREATE_PROCESS_DEBUG_EVENT 3	Segnala un evento di debug create-process (include sia un processo che il relativo thread principale). Il valore di u.CreateProcessInfo specifica una struttura CREATE_PROCESS_DEBUG_INFO .
CREATE_THREAD_DEBUG_EVENT 2	Segnala un evento di debug create-thread (non include il thread principale di un processo, vedere "CREATE_PROCESS_DEBUG_EVENT"). Il valore u.CreateThread specifica una struttura CREATE_THREAD_DEBUG_INFO .
EXCEPTION_DEBUG_EVENT 1	Segnala un evento di debug delle eccezioni. Il valore u.Exception specifica una struttura EXCEPTION_DEBUG_INFO .
EXIT_PROCESS_DEBUG_EVENT 5	Segnala un evento di debug di exit-process. Il valore u.ExitProcess specifica una struttura EXIT_PROCESS_DEBUG_INFO .
EXIT_THREAD_DEBUG_EVENT 4	Segnala un evento di debug di exit-thread. Il valore u.ExitThread specifica una struttura EXIT_THREAD_DEBUG_INFO .
LOAD_DLL_DEBUG_EVENT 6	Segnala un evento di debug di load-dynamic-link-library (DLL). Il valore u.LoadDll specifica una struttura LOAD_DLL_DEBUG_INFO .
OUTPUT_DEBUG_STRING_EVENT 8	Segnala un evento di debug di stringhe di output. Il valore u.DebugString specifica una struttura OUTPUT_DEBUG_STRING_INFO .
RIP_EVENT 9	Segnala un evento rip-debug (errore di debug del sistema). Il valore di u.RipInfo specifica una struttura RIP_INFO .
UNLOAD_DLL_DEBUG_EVENT 7	Segnala un evento di debug della DLL di scaricamento. Il valore u.UnloadDll specifica una struttura UNLOAD_DLL_DEBUG_INFO .

dwProcessId

Tipo: DWORD

Identificatore del processo in cui si è verificato l'evento di debug. Un debugger usa questo valore per individuare la struttura per processo del debugger. Questi valori non sono necessariamente numeri interi di piccole dimensioni che possono essere usati come indici di tabella.

dwThreadId

Tipo: DWORD

Identificatore del thread in cui si è verificato l'evento di debug. Un debugger usa questo valore per individuare la struttura per thread del debugger. Questi valori non sono necessariamente numeri interi di piccole dimensioni che possono essere usati come indici di tabella.

u

Eventuali informazioni aggiuntive relative all'evento di debug. Questa unione accetta il tipo e il valore appropriati al tipo di evento di debug, come descritto nel membro dwDebugEventCode .

u.Exception

Tipo: EXCEPTION_DEBUG_INFO Se dwDebugEventCode è EXCEPTION_DEBUG_EVENT (1), u.Exception specifica una struttura EXCEPTION_DEBUG_INFO .

u.CreateThread

Tipo: CREATE_THREAD_DEBUG_INFO Se dwDebugEventCode è CREATE_THREAD_DEBUG_EVENT (2), u.CreateThread specifica una struttura CREATE_THREAD_DEBUG_INFO .

u.CreateProcessInfo

Tipo: CREATE_PROCESS_DEBUG_INFO Se dwDebugEventCode è CREATE_PROCESS_DEBUG_EVENT (3), u.CreateProcessInfo specifica una struttura CREATE_PROCESS_DEBUG_INFO .

u.ExitThread

Tipo: EXIT_THREAD_DEBUG_INFO Se dwDebugEventCode è EXIT_THREAD_DEBUG_EVENT (4), u.ExitThread specifica una struttura EXIT_THREAD_DEBUG_INFO .

u.ExitProcess

Tipo: EXIT_PROCESS_DEBUG_INFO Se dwDebugEventCode è EXIT_PROCESS_DEBUG_EVENT (5), u.ExitProcess specifica una struttura EXIT_PROCESS_DEBUG_INFO .

u.LoadDll

Tipo: LOAD_DLL_DEBUG_INFO Se dwDebugEventCode è LOAD_DLL_DEBUG_EVENT (6), u.LoadDll specifica una struttura LOAD_DLL_DEBUG_INFO .

u.UnloadDll

Tipo: UNLOAD_DLL_DEBUG_INFO Se dwDebugEventCode è UNLOAD_DLL_DEBUG_EVENT (7), u.UnloadDll specifica una struttura UNLOAD_DLL_DEBUG_INFO .

u.DebugString

Tipo: OUTPUT_DEBUG_STRING_INFO Se dwDebugEventCode è OUTPUT_DEBUG_STRING_EVENT (8), u.DebugString specifica una struttura OUTPUT_DEBUG_STRING_INFO .

u.RipInfo

Tipo: RIP_INFO Se dwDebugEventCode è RIP_EVENT (9), u.RipInfo specifica una struttura RIP_INFO .

Commenti

Se la funzione WaitForDebugEvent ha esito positivo, inserisce i membri di una struttura DEBUG_EVENT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	minwinbase.h (includere Windows.h)