Membuat Ekstensi EngExtCpp

Pustaka ekstensi EngExtCpp dapat menyertakan kode C++ standar apa pun. Ini juga dapat mencakup antarmuka C++ yang muncul dalam file header engextcpp.h dan dbgeng.h, selain fungsi C yang muncul di file header wdbgexts.h. Baik dbgeng.h maupun wdbgexts.h disertakan dari engextcpp.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. Saat menyertakan wdbgexts.h, engextcpp.h memilih API versi 64-bit. Variabel global ExtensionApis yang digunakan oleh WDbgExts API secara otomatis diinisialisasi saat masuk ke metode EngExtCpp dan dibersihkan saat keluar.

Ketika ekstensi EngExtCpp digunakan dengan antarmuka DbgEng jarak jauh, antarmuka WDbgExts tidak akan tersedia dan struktur ExtensionApis dapat disetel ke nol. Jika ekstensi EngExtCpp diharapkan berfungsi di lingkungan seperti itu, ekstensi tersebut harus menghindari penggunaan API WDbgExts.

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