Condividi tramite

Compilazione di estensioni WdbgExts

  • Articolo

Tutte le estensioni del debugger devono essere compilate e compilate con l'utilità Build. L'utilità Build è inclusa in Windows Driver Kit (WDK) e nelle versioni precedenti di Windows DDK.

Tenere presente quanto segue:

  • WDK ha diverse finestre di ambiente di compilazione. Ognuno di questi ha un collegamento corrispondente posizionato nel menu Start quando viene installato WDK. Per creare un'estensione del debugger, è necessario usare l'ambiente di compilazione windows più recente, indipendentemente dalla piattaforma in cui si esegue l'estensione.

  • L'utilità Build non è in genere in grado di compilare il codice che si trova in un percorso di directory contenente spazi. Il codice di estensione deve trovarsi in una directory il cui percorso completo non contiene spazi. In particolare, questo significa che se si installa Debug Tools per Windows nel percorso predefinito - Programmi\Strumenti di debug per Windows - non sarà possibile compilare le estensioni di esempio.

Per compilare un'estensione del debugger

  1. Aprire la finestra per l'ambiente di compilazione windows più recente. È possibile scegliere la versione "gratuita" o la versione "selezionata", che darà risultati identici a meno che non siano state inserite #ifdef istruzioni DBG nel codice.

  2. Impostare la variabile _NT_TARGET_VERSION per indicare la versione meno recente di Windows in cui si vuole eseguire l'estensione. _NT_TARGET_VERSION può essere impostato sui valori seguenti.

    Valore Versioni di Windows

    _NT_TARGET_VERSION_WIN2K

    Windows 2000 e versioni successive.

    _NT_TARGET_VERSION_WINXP

    Windows XP e versioni successive.

    _NT_TARGET_VERSION_WS03

    Windows Server 2003 e versioni successive.

    _NT_TARGET_VERSION_LONGHORN

    Windows Vista e versioni successive.

Se _NT_TARGET_VERSION non è impostato, l'estensione verrà eseguita solo nella versione di Windows per cui è stata aperta la finestra di compilazione (e versioni successive). Ad esempio, inserire la riga seguente nel file Sources creerà un'estensione che verrà eseguita in Windows: console _NT_TARGET_VERSION = $(_NT_TARGET_VERSION_WINXP)

  1. Impostare rispettivamente le variabili di ambiente DBGSDK_INC_PATH e DBGSDK_LIB_PATH per specificare i percorsi per le intestazioni sdk del debugger e le librerie SDK del debugger. Se %debuggers% rappresenta la radice degli strumenti di debug per l'installazione di Windows, queste variabili devono essere impostate come segue:

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

    Se queste intestazioni e librerie sono state spostate in una posizione diversa, specificare invece tale posizione.

  2. Modificare la directory corrente nella directory contenente il file Dirs dell'estensione o il file Sources.

  3. Eseguire l'utilità Di compilazione:

    build -cZMg

Per una spiegazione completa di questi passaggi e per una descrizione di come creare un file Dirs e un file Sources, vedere la documentazione dell'utilità di compilazione in WDK.