struktur DEBUG_EVENT (minwinbase.h)

Artikel
08/24/2023

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
CREATE_PROCESS_DEBUG_EVENT 3	Melaporkan peristiwa penelusuran kesalahan proses buat -proses (termasuk proses dan utas utamanya). Nilai u.CreateProcessInfo menentukan struktur CREATE_PROCESS_DEBUG_INFO .
CREATE_THREAD_DEBUG_EVENT 2	Melaporkan peristiwa debugging create-thread (tidak menyertakan utas utama proses, lihat 'CREATE_PROCESS_DEBUG_EVENT'). Nilai u.CreateThread menentukan struktur CREATE_THREAD_DEBUG_INFO .
EXCEPTION_DEBUG_EVENT 1	Melaporkan peristiwa debugging pengecualian. Nilai u.Exception menentukan struktur EXCEPTION_DEBUG_INFO .
EXIT_PROCESS_DEBUG_EVENT 5	Melaporkan peristiwa penelusuran kesalahan proses keluar. Nilai u.ExitProcess menentukan struktur EXIT_PROCESS_DEBUG_INFO .
EXIT_THREAD_DEBUG_EVENT 4	Melaporkan peristiwa penelusuran kesalahan exit-thread. Nilai u.ExitThread menentukan struktur EXIT_THREAD_DEBUG_INFO .
LOAD_DLL_DEBUG_EVENT 6	Melaporkan peristiwa penelusuran kesalahan load-dynamic-link-library (DLL). Nilai u.LoadDll menentukan struktur LOAD_DLL_DEBUG_INFO .
OUTPUT_DEBUG_STRING_EVENT 8	Melaporkan peristiwa debugging-string output. Nilai u.DebugString menentukan struktur OUTPUT_DEBUG_STRING_INFO .
RIP_EVENT 9	Melaporkan peristiwa penelusuran kesalahan RIP (kesalahan penelusuran kesalahan sistem). Nilai u.RipInfo menentukan struktur RIP_INFO .
UNLOAD_DLL_DEBUG_EVENT 7	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)