struttura DEBUG_EVENT (minwinbase.h)

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.

Value	Meaning
CREATE_PROCESS_DEBUG_EVENT 3	Segnala un evento di debug del processo di creazione (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 di u.CreateThread specifica una struttura CREATE_THREAD_DEBUG_INFO .
EXCEPTION_DEBUG_EVENT 1	Segnala un evento di debug delle eccezioni. Il valore di u.Exception specifica una struttura EXCEPTION_DEBUG_INFO .
EXIT_PROCESS_DEBUG_EVENT 5	Segnala un evento di debug di exit-process. Il valore di u.ExitProcess specifica una struttura EXIT_PROCESS_DEBUG_INFO .
EXIT_THREAD_DEBUG_EVENT 4	Segnala un evento di debug del thread di uscita. Il valore di 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 di 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 di u.DebugString specifica una struttura OUTPUT_DEBUG_STRING_INFO .
RIP_EVENT 9	Segnala un evento di debug RIP (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 di unload-DLL. Il valore di 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 assume il tipo e il valore appropriati per il 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 .

Osservazioni:

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

Requisiti

Requisito	Value
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Header	minwinbase.h (include Windows.h)

Vedere anche

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