struktur DEBUG_EVENT (minwinbase.h)
Menjelaskan peristiwa penelusuran kesalahan.
Sintaks
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;
Anggota
dwDebugEventCode
Jenis: DWORD
Kode yang mengidentifikasi jenis peristiwa penelusuran kesalahan. Anggota ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Melaporkan peristiwa penelusuran kesalahan proses buat -proses (termasuk proses dan utas utamanya). Nilai u.CreateProcessInfo menentukan struktur CREATE_PROCESS_DEBUG_INFO . |
|
Melaporkan peristiwa debugging create-thread (tidak menyertakan utas utama proses, lihat 'CREATE_PROCESS_DEBUG_EVENT'). Nilai u.CreateThread menentukan struktur CREATE_THREAD_DEBUG_INFO . |
|
Melaporkan peristiwa debugging pengecualian. Nilai u.Exception menentukan struktur EXCEPTION_DEBUG_INFO . |
|
Melaporkan peristiwa penelusuran kesalahan proses keluar. Nilai u.ExitProcess menentukan struktur EXIT_PROCESS_DEBUG_INFO . |
|
Melaporkan peristiwa penelusuran kesalahan exit-thread. Nilai u.ExitThread menentukan struktur EXIT_THREAD_DEBUG_INFO . |
|
Melaporkan peristiwa penelusuran kesalahan load-dynamic-link-library (DLL). Nilai u.LoadDll menentukan struktur LOAD_DLL_DEBUG_INFO . |
|
Melaporkan peristiwa debugging-string output. Nilai u.DebugString menentukan struktur OUTPUT_DEBUG_STRING_INFO . |
|
Melaporkan peristiwa penelusuran kesalahan RIP (kesalahan penelusuran kesalahan sistem). Nilai u.RipInfo menentukan struktur RIP_INFO . |
|
Melaporkan peristiwa debugging UNLOAD-DLL. Nilai u.UnloadDll menentukan struktur UNLOAD_DLL_DEBUG_INFO . |
dwProcessId
Jenis: DWORD
Pengidentifikasi proses di mana peristiwa debugging terjadi. Debugger menggunakan nilai ini untuk menemukan struktur per proses debugger. Nilai-nilai ini belum tentu bilangan bulat kecil yang dapat digunakan sebagai indeks tabel.
dwThreadId
Jenis: DWORD
Pengidentifikasi utas tempat peristiwa penelusuran kesalahan terjadi. Debugger menggunakan nilai ini untuk menemukan struktur per alur debugger. Nilai-nilai ini belum tentu bilangan bulat kecil yang dapat digunakan sebagai indeks tabel.
u
Informasi tambahan apa pun yang berkaitan dengan peristiwa penelusuran kesalahan. Serikat ini mengambil jenis dan nilai yang sesuai dengan jenis peristiwa penelusuran kesalahan, seperti yang dijelaskan dalam anggota dwDebugEventCode .
u.Exception
Jenis: EXCEPTION_DEBUG_INFO Jika dwDebugEventCodeEXCEPTION_DEBUG_EVENT (1), u.Exception menentukan struktur EXCEPTION_DEBUG_INFO .
u.CreateThread
Jenis: CREATE_THREAD_DEBUG_INFO Jika dwDebugEventCodeCREATE_THREAD_DEBUG_EVENT (2), u.CreateThread menentukan struktur CREATE_THREAD_DEBUG_INFO .
u.CreateProcessInfo
Jenis: CREATE_PROCESS_DEBUG_INFO Jika dwDebugEventCodeCREATE_PROCESS_DEBUG_EVENT (3), u.CreateProcessInfo menentukan struktur CREATE_PROCESS_DEBUG_INFO .
u.ExitThread
Jenis: EXIT_THREAD_DEBUG_INFO Jika dwDebugEventCodeEXIT_THREAD_DEBUG_EVENT (4), u.ExitThread menentukan struktur EXIT_THREAD_DEBUG_INFO .
u.ExitProcess
Jenis: EXIT_PROCESS_DEBUG_INFO Jika dwDebugEventCodeEXIT_PROCESS_DEBUG_EVENT (5), u.ExitProcess menentukan struktur EXIT_PROCESS_DEBUG_INFO .
u.LoadDll
Jenis: LOAD_DLL_DEBUG_INFO Jika dwDebugEventCodeLOAD_DLL_DEBUG_EVENT (6), u.LoadDll menentukan struktur LOAD_DLL_DEBUG_INFO .
u.UnloadDll
Jenis: UNLOAD_DLL_DEBUG_INFO Jika dwDebugEventCodeUNLOAD_DLL_DEBUG_EVENT (7), u.UnloadDll menentukan struktur UNLOAD_DLL_DEBUG_INFO .
u.DebugString
Jenis: OUTPUT_DEBUG_STRING_INFO Jika dwDebugEventCodeOUTPUT_DEBUG_STRING_EVENT (8), u.DebugString menentukan struktur OUTPUT_DEBUG_STRING_INFO .
u.RipInfo
Jenis: RIP_INFO Jika dwDebugEventCodeRIP_EVENT (9), u.RipInfo menentukan struktur RIP_INFO .
Keterangan
Jika fungsi WaitForDebugEvent berhasil, fungsi tersebut akan mengisi anggota struktur DEBUG_EVENT .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Header | minwinbase.h (termasuk Windows.h) |