struktur DEBUG_EVENT (minwinbase.h)

Menjelaskan peristiwa penelusuran kesalahan.

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

Jenis: DWORD

Kode yang mengidentifikasi jenis peristiwa penelusuran kesalahan. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Meaning
CREATE_PROCESS_DEBUG_EVENT
3
Melaporkan peristiwa debugging proses buat (mencakup proses dan utas utamanya). Nilai u.CreateProcessInfo menentukan struktur CREATE_PROCESS_DEBUG_INFO .
CREATE_THREAD_DEBUG_EVENT
2
 Melaporkan peristiwa penelusuran kesalahan 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 alur keluar. 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 penelusuran kesalahan output-debugging-string. 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 penelusuran kesalahan 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. Penyatuan 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 .

Komentar

Jika fungsi WaitForDebugEvent berhasil, fungsi tersebut 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)

Lihat juga

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

  • Last updated on