WdbgExts-extensies bouwen

Alle extensies voor foutopsporingsprogramma's moeten worden gecompileerd en gebouwd met het build-hulpprogramma. Het buildhulpprogramma is opgenomen in de Windows Driver Kit (WDK) en in eerdere versies van de Windows DDK.

Let op de volgende punten:

• De WDK heeft verschillende build-omgevingvensters. Elk van deze heeft een bijbehorende snelkoppeling die in het menu Start wordt geplaatst wanneer de WDK is geïnstalleerd. Als u een foutopsporingsprogramma-extensie wilt bouwen, moet u de nieuwste Windows-buildomgeving gebruiken, ongeacht het platform waarop u de extensie gaat uitvoeren.

• Het hulpprogramma Build kan meestal geen code compileren die zich in een mappad bevindt dat spaties bevat. De extensiecode moet zich in een map bevinden waarvan het volledige pad geen spaties bevat. (Dit betekent met name dat als u Hulpprogramma's voor foutopsporing voor Windows installeert op de standaardlocatie -- Program Files\Foutopsporingsprogramma's voor Windows - u de voorbeeldextensies niet kunt bouwen.)

Een foutopsporingsprogramma-extensie maken

1. Open het venster voor de nieuwste Windows-buildomgeving. (U kunt kiezen voor de gratis versie of de versie 'gecontroleerd'. Ze geven identieke resultaten, tenzij u #ifdef DBG-instructies in uw code hebt geplaatst.)

2. Stel de variabele in _NT_TARGET_VERSION om de oudste versie van Windows aan te geven waarop u de extensie wilt uitvoeren. _NT_TARGET_VERSION kan worden ingesteld op de volgende waarden.

   Waarde	Versies van Windows
   _NT_TARGET_VERSION_WIN2K	Windows 2000 en hoger.
   _NT_TARGET_VERSION_WINXP	Windows XP en hoger.
   _NT_TARGET_VERSION_WS03	Windows Server 2003 en hoger.
   _NT_TARGET_VERSION_LONGHORN	Windows Vista en hoger.

Als _NT_TARGET_VERSION niet is ingesteld, wordt de extensie alleen uitgevoerd op de versie van Windows waarvoor het buildvenster is geopend (en latere versies). Als u bijvoorbeeld de volgende regel in het bronbestand plaatst, wordt er een extensie gebouwd die wordt uitgevoerd in Windows: console _NT_TARGET_VERSION = $(_NT_TARGET_VERSION_WINXP)

3. Stel de DBGSDK_INC_PATH en DBGSDK_LIB_PATH omgevingsvariabelen in om respectievelijk de paden naar de SDK-headers voor foutopsporingsprogramma's en de SDK-bibliotheken voor foutopsporingsprogramma's op te geven. Als %debuggers% de hoofdmap van uw Debugging-tools voor Windows-installatie vertegenwoordigt, moeten deze variabelen als volgt worden ingesteld:

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

   Als u deze headers en bibliotheken naar een andere locatie hebt verplaatst, geeft u die locatie op.

4. Wijzig de huidige map in de map die het Dirs-bestand of bronnenbestand van uw extensie bevat.

5. Voer het buildhulpprogramma uit:

   build -cZMg
   

Voor een volledige uitleg van deze stappen en voor een beschrijving van het maken van een Dirs-bestand en een bronnenbestand, raadpleegt u de documentatie over het build-hulpprogramma in de WDK.