Pengembangan Ekstensi WdbgExts

Semua ekstensi debugger harus dikompilasi dan dibangun dengan utilitas Build. Utilitas Build disertakan dalam Windows Driver Kit (WDK) dan dalam versi Windows DDK yang lebih lama.

Perhatikan poin-poin berikut:

• WDK memiliki beberapa jendela lingkungan build yang berbeda. Masing-masing memiliki pintasan yang sesuai yang ditempatkan di menu Mulai saat WDK diinstal. Untuk membangun ekstensi debugger, Anda harus menggunakan lingkungan build Windows terbaru, terlepas dari platform apa yang akan Anda jalankan ekstensinya.

• Utilitas Build biasanya tidak dapat mengkompilasi kode yang terletak di jalur direktori yang berisi spasi. Kode ekstensi Anda harus terletak di direktori yang jalur lengkapnya tidak berisi spasi. (Secara khusus, ini berarti bahwa jika Anda menginstal Alat Debugging untuk Windows ke lokasi default -- Program Files\Debugging Tools for Windows -- Anda tidak akan dapat membangun ekstensi sampel.)

Untuk membangun ekstensi debugger

1. Buka jendela untuk lingkungan build Windows terbaru. (Anda dapat memilih versi "gratis" atau versi "diperiksa" - mereka akan memberikan hasil yang identik kecuali Anda telah memasukkan pernyataan DBG #ifdef dalam kode Anda.)

2. Atur variabel _NT_TARGET_VERSION untuk menunjukkan versi Windows terlama tempat Anda ingin menjalankan ekstensi. _NT_TARGET_VERSION dapat diatur ke nilai berikut.

   Nilai	Versi Windows
   _NT_TARGET_VERSION_WIN2K	Windows 2000 dan yang lebih baru.
   _NT_TARGET_VERSION_WINXP	Windows XP dan yang lebih baru.
   _NT_TARGET_VERSION_WS03	Windows Server 2003 dan yang lebih baru.
   _NT_TARGET_VERSION_LONGHORN	Windows Vista dan yang lebih baru.

Jika _NT_TARGET_VERSION tidak diatur, ekstensi hanya akan berjalan pada versi Windows tempat jendela build dibuka (dan versi yang lebih baru). Misalnya, menempatkan baris berikut dalam file Sumber Anda akan membangun ekstensi yang akan berjalan di Windows: console _NT_TARGET_VERSION = $(_NT_TARGET_VERSION_WINXP)

3. Atur variabel lingkungan DBGSDK_INC_PATH dan DBGSDK_LIB_PATH untuk menentukan jalur ke header SDK debugger dan pustaka SDK debugger. Jika %debuggers% mewakili akar Alat Debugging untuk penginstalan Windows Anda, variabel ini harus diatur sebagai berikut:

   set DBGSDK_INC_PATH=%debuggers%\sdk\inc
   set DBGSDK_LIB_PATH=%debuggers%\sdk\lib
   

   Jika Anda telah memindahkan header dan pustaka ini ke lokasi lain, tentukan lokasi tersebut sebagai gantinya.

4. Ubah direktori saat ini ke direktori yang berisi file Dirs atau file Sumber ekstensi Anda.

5. Jalankan utilitas Build:

   build -cZMg
   

Untuk penjelasan lengkap tentang langkah-langkah ini, dan untuk deskripsi tentang cara membuat file Dirs dan file Sumber, lihat dokumentasi Utilitas build di WDK.