Erstellen von BDA-Treibern

Hinweis Ab Windows 8 verwendet die WDK-Buildumgebung nicht mehr Build.exe. Weitere Informationen finden Sie unter WDK- und Visual Studio-Buildumgebung. Die folgende Diskussion gilt nur, wenn Sie Ihren Treiber mit der WDK Windows 7-Version oder früher erstellen.

Sie können das Microsoft Windows Driver Kit (WDK) verwenden, um Ihren BDA-Treiber (Broadcast Driver Architecture) zu erstellen. Um einen BDA-Treiber zu erstellen, öffnen Sie ein WDK-Buildumgebungsfenster, wechseln Sie in das unterverzeichnis quellcode des entsprechenden BDA-Treibers des Standard Quellverzeichnisses des WDK, und verwenden Sie den Buildbefehl. Der Buildbefehl ruft Anweisungen zum Erstellen des BDA-Treibers aus der Sources-Datei ab, die sich im Quellcodeunterverzeichnis des BDA-Treibers befindet.

Weitere Informationen zum Build-Hilfsprogramm, zu den Buildumgebungen des WDK, zu den Makros und Umgebungsvariablen, die das Build-Hilfsprogramm steuern, und zu den Dateien, die zum Erstellen Ihres BDA-Treibers erforderlich sind, finden Sie unter Verwenden des Build-Hilfsprogramms und Buildhilfsprogrammreferenz in der Windows 7 WDK-Dokumentation (Build 7600).

Die folgende Liste enthält die Makronamen, die in einer BDA-Quellendatei verwendet werden sollen, und erläutert, wie Sie sie zum Erstellen Ihres BDA-Treibers verwenden können:

TARGETNAME
Legen Sie den Namen des BDA-Treibers fest, damit der WDK den Treiber mit diesem Namen erstellt. Der folgende Code veranschaulicht dies:

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

TARGETPATH
Legen Sie das Zielverzeichnis für den erstellten Treiber fest. Beachten Sie, dass Sie abhängig davon, ob Ihre Buildumgebung "free" oder "checked" ist, die variable BUILD_ALT_DIR verwenden können, um "fre" oder "chk" an das Unterverzeichnis \obj anzufügen, das der Buildbefehl unter dem Verzeichnis erstellt, das die Sources-Datei enthält. Der folgende Code veranschaulicht dies:

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

TARGETTYPE
Legen Sie den Dateityp fest, der als Treiber erstellt werden soll (im Gegensatz zu z. B. einem Programm oder einer DLL), wie im folgenden Code gezeigt:

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

TARGETLIBS
Zeigen Sie auf die Bibliotheksdateien, mit denen die Beispielquelle des BDA-Treibers verknüpft werden muss. Ein BDA-Treiber muss mindestens einen Link zu den Bibliotheken im folgenden Codebeispiel herstellen:

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

ENTHÄLT
Zeigen Sie auf eine Liste von Pfaden zum Suchen nach den Headerdateien, die die Beispielquelle des BDA-Treibers zum Kompilieren benötigt. Der folgende Code veranschaulicht dies:

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

QUELLEN
Zeigen Sie auf eine Liste der Quelldateien, die zum Erstellen des Treibers kompiliert werden müssen. Die Dateien müssen sich in dem Verzeichnis befinden, in dem sich die Sources-Datei befindet. Der folgende Code veranschaulicht dies:

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

DRIVERTYPE
Legen Sie den Treibertyp wie im folgenden Code gezeigt auf WDM fest:

DRIVERTYPE=WDM

USE_MAPSYM
Generieren Sie sym-Symboldateien zusätzlich zu den PDB-Symboldateien . Diese Dateien ordnen Namen Adressen zu. Das Festlegen dieses Makros ist zum Debuggen auf Windows 98/Me-Plattformen erforderlich. Legen Sie dieses Makro wie im folgenden Beispiel gezeigt fest:

USE_MAPSYM=1