Compilazione di driver BDA

Nota A partire da Windows 8, l'ambiente di compilazione WDK non usa più Build.exe. Vedi WDK e Ambiente Di Compilazione Di Visual Studio. La discussione seguente si applica solo se si compila il driver usando wdk Windows 7 versione o precedente.

Puoi usare Microsoft Windows Driver Kit (WDK) per compilare il driver BDA (Broadcast Driver Architecture). Per compilare un driver BDA, aprire una finestra dell'ambiente di compilazione WDK, passare alla sottodirectory del codice sorgente del driver BDA appropriata della directory di origine principale di WDK e usare il comando di compilazione . Il comando di compilazione ottiene istruzioni su come compilare il driver BDA dal file Sources che risiede nella sottodirectory del codice sorgente del driver BDA.

Per altre informazioni sull'utilità di compilazione, gli ambienti di compilazione di WDK, le macro e le variabili di ambiente che controllano l'utilità di compilazione e i file necessari per compilare il driver BDA, vedere "Using the Build Utility" (Uso dell'utilità di compilazione) e "Build Utility Reference" nella documentazione di Windows 7 WDK (build 7600).

L'elenco seguente contiene i nomi di macro da usare in un file di origini BDA e illustra come usarli per compilare il driver BDA:

TARGETNAME
Impostare il nome del driver BDA in modo che quando WDK compila il driver, sia compilato con questo nome. Nel codice seguente ne viene illustrato un esempio:

TARGETNAME=BDAsampl  # WDK builds the driver as BDAsampl.sys

TARGETPATH
Impostare la directory di destinazione per il driver compilato. Si noti che a seconda che l'ambiente di compilazione sia "gratuito" o "selezionato", è possibile usare la variabile BUILD_ALT_DIR per aggiungere "fre" o "chk" alla sottodirectory \obj creata dal comando di compilazione nella directory contenente il file Sources . Nel codice seguente ne viene illustrato un esempio:

TARGETPATH=obj$(BUILD_ALT_DIR) # built driver in \objfre or \objchk

TARGETTYPE
Impostare il tipo di file da compilare come driver ,anziché come programma o DLL, come illustrato nel codice seguente:

TARGETTYPE=DRIVER  # WDK builds the driver as *.sys

TARGETLIBS
Indicare i file di libreria a cui il codice sorgente di esempio del driver BDA deve collegarsi. Un driver BDA deve almeno collegarsi alle librerie illustrate nell'esempio di codice seguente:

TARGETLIBS=..\..\..\..\lib\ks.lib \
           ..\..\..\..\lib\ksguid.lib \
           ..\..\..\..\lib\BdaSup.lib

INCLUDE
Indicare un elenco di percorsi per cercare i file di intestazione che il codice sorgente di esempio del driver BDA richiede per la compilazione. Nel codice seguente ne viene illustrato un esempio:

INCLUDES=..\..\..\..\inc; \
    $(DDK_INC_PATH)\wdm; 

FONTI
Puntare a un elenco di file di origine che devono essere compilati per costruire il driver. I file devono trovarsi nella directory in cui risiede il file Sources . Nel codice seguente ne viene illustrato un esempio:

SOURCES= \
    ObjDesc.cpp     \
    inpin.cpp     \
    outpin.cpp    \
    Filter.cpp      \
    Device.cpp      \
    bdaguid.c       \
    BDAsampl.rc

TIPO DI DRIVER
Impostare il tipo di driver su WDM, come illustrato nel codice seguente:

DRIVERTYPE=WDM

USE_MAPSYM
Generare file di simboli con estensione sym , oltre ai file di simboli con estensione pdb . Questi file associano i nomi agli indirizzi. L'impostazione di questa macro è necessaria per eseguire il debug nelle piattaforme Windows 98/Me. Impostare questa macro come illustrato nell'esempio seguente:

USE_MAPSYM=1