Menulis Kode Ekstensi DbgEng

Perintah ekstensi DbgEng dapat menyertakan kode C++ standar apa pun. Mereka juga dapat menyertakan antarmuka C++ yang muncul dalam file header dbgeng.h, selain fungsi C yang muncul di file header wdbgexts.h.

Jika Anda ingin menggunakan fungsi dari wdbgexts.h, Anda perlu menentukan KDEXT_64BIT sebelum wdbgexts.h disertakan. Contohnya:

#define KDEXT_64BIT
#include wdbgexts.h
#include dbgeng.h

Untuk daftar lengkap antarmuka di dbgeng.h yang dapat digunakan dalam perintah ekstensi, lihat Referensi Mesin Debugger.

Untuk daftar lengkap fungsi dalam wdbgexts.h yang dapat digunakan dalam perintah ekstensi, lihat Fungsi WdbgExts. Sejumlah fungsi ini muncul dalam versi 32-bit dan versi 64-bit. Biasanya, versi 64-bit berakhiran "64" dan versi 32-bit tidak memiliki akhiran numerik -- misalnya, ReadIoSpace64 dan ReadIoSpace. Saat memanggil fungsi wdbgexts.h dari ekstensi DbgEng, Anda harus selalu menggunakan nama fungsi yang berakhiran "64". Ini karena mesin debugger selalu menggunakan pointer 64-bit secara internal, terlepas dari platform target.

Jika Anda menyertakan wdbgexts.h dalam ekstensi DbgEng, Anda harus memanggil GetWindbgExtensionApis64 selama inisialisasi DLL ekstensi Anda (lihat DebugExtensionInitialize).

Nota Anda tidak boleh mencoba memanggil rutinitas DbgHelp atau ImageHlp dari ekstensi debugger apa pun. Memanggil rutinitas ini tidak didukung dan dapat menyebabkan berbagai masalah.