WdbgExts Uzantıları Oluşturma

Tüm hata ayıklayıcı uzantıları Build aracıyla derlenmeli ve oluşturulmalıdır. Build aracı, Windows Sürücü Kiti (WDK) ve eski Windows Sürücü Geliştirme Kiti (DDK) sürümlerinde yer almaktadır.

Aşağıdaki noktaları not edin:

• WDK'nin birkaç farklı derleme ortamı penceresi vardır. Bunların her birinde, WDK yüklendiğinde Başlat menüsüne yerleştirilen karşılık gelen bir kısayol bulunur. Bir hata ayıklayıcısı uzantısı oluşturmak için, uzantıyı hangi platformda çalıştıracağınız fark etmeksizin en son Windows derleme ortamını kullanmanız gerekir.

• Derleme yardımcı programı genellikle boşluk içeren bir dizin yolunda bulunan kodu derleyemez. Uzantı kodunuz, tam yolu boşluk içermeyen bir dizinde bulunmalıdır. (Özellikle bu, Windows için Hata Ayıklama Araçları'nı varsayılan konuma (Program Files\Debugging Tools for Windows) yüklerseniz örnek uzantıları oluşturamayacağınız anlamına gelir.)

Hata ayıklayıcı uzantısı oluşturmak için

1. En son Windows derleme ortamı penceresini açın. ("Ücretsiz" sürümü veya "işaretli" sürümü seçebilirsiniz; kodunuza #ifdef DBG deyimleri koymadığınız sürece bunlar aynı sonuçları verir.)

2. Uzantıyı çalıştırmak istediğiniz en eski Windows sürümünü belirtmek için _NT_TARGET_VERSION değişkenini ayarlayın. _NT_TARGET_VERSION aşağıdaki değerlere ayarlanabilir.

   Değer	Windows sürümleri
   _NT_TARGET_VERSION_WIN2K	Windows 2000 ve üzeri.
   _NT_TARGET_VERSION_WINXP	Windows XP ve üzeri.
   _NT_TARGET_VERSION_WS03	Windows Server 2003 ve üzeri.
   _NT_TARGET_VERSION_LONGHORN	Windows Vista ve üzeri.

_NT_TARGET_VERSION ayarlanmadıysa, uzantı yalnızca derleme penceresinin açıldığı Windows sürümünde (ve sonraki sürümlerde) çalışır. Örneğin, Kaynaklar dosyanıza aşağıdaki satırın eklenmesi, Windows'da çalışacak bir uzantı oluşturur: console _NT_TARGET_VERSION = $(_NT_TARGET_VERSION_WINXP)

3. Sırasıyla hata ayıklayıcı SDK üst bilgilerinin ve hata ayıklayıcı SDK kitaplıklarının yollarını belirtmek için DBGSDK_INC_PATH ve DBGSDK_LIB_PATH ortam değişkenlerini ayarlayın. %debuggers% Windows için Hata Ayıklama Araçları yüklemenizin kökünü temsil ederse, bu değişkenler aşağıdaki gibi ayarlanmalıdır:

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

   Bu üst bilgileri ve kitaplıkları farklı bir konuma taşıdıysanız, bunun yerine bu konumu belirtin.

4. Geçerli dizini, uzantınızın Dirs dosyasını veya Sources dosyasını içeren dizin olarak değiştirin.

5. Derleme yardımcı programını çalıştırın:

   build -cZMg
   

Bu adımların tam açıklaması ve Dirs dosyası ve Sources dosyası oluşturma hakkında bir açıklama için WDK'deki Derleme yardımcı programı belgelerine bakın.