Freigeben über

Konfigurieren einer INF-Datei für einen ändernden Filtertreiber

Die folgenden NDIS-Filtertreiberinstallationsprobleme sind mit dem Ändern von Filtertreibern verbunden. Um eine eigene INF-Datei für einen modifizierenden Filtertreiber zu erstellen, können Sie auch den Beispielfiltertreiber für NDIS 6.0 anpassen.

  • Setzen Sie den Class-INF-Dateieintrag in der INF-Datei auf NetService fest. Das folgende Beispiel zeigt einen Beispielklasseneintrag für die INF-Datei.

    Class = NetService

  • Der Abschnitt "DDInstall " in einer INF-Datei des Filtertreibers muss über einen Eigenschafteneintrag verfügen. Das folgende Beispiel zeigt, wie Sie den Eintrag "Merkmale" in der INF-Filterdatei definieren sollten.

    Characteristics=0x40000

    Der wert 0x40000 gibt an, dass NCF_LW_FILTER (0x40000) festgelegt ist. Filtertreiber dürfen das NCF_FILTER-Flag (0x400) nicht festlegen. Die Werte der NCF_ Xxx-Flags werden in Netcfgx.h definiert. Weitere Informationen zu NCF_ Xxx-Flags finden Sie im Abschnitt "DDInstall" in einer Netzwerk-INF-Datei.

  • Legen Sie den NetCfgInstanceId INF-Dateieintrag in der INF-Datei fest, wie im folgenden Beispiel gezeigt.

    NetCfgInstanceId="{5cbf81bd-5055-47cd-9055-a76b2b4e3697}"

    Sie können das toolUuidgen.exe verwenden, um die GUID für den NetCfgInstanceId-Eintrag zu erstellen.

  • Der DDInstall-Abschnitt der INF-Datei für einen Filtertreiber muss eine Addreg-Direktive für einen Ndi-Schlüssel enthalten. Die INF-Datei muss den Diensteintrag unter dem Ndi-Schlüssel angeben. Der ServiceBinary-Eintrag im Abschnitt " Dienstinstallation" der INF-Datei gibt den Pfad zur Binärdatei für den Filtertreiber an. Weitere Informationen finden Sie unter Hinzufügen von Dienstbezogenen Werten zum Abschnitt "Ndi Key " und "DDInstall.Services" in einer Netzwerk-INF-Datei.

  • Der Abschnitt "DDInstall " in einer INF-Datei des Filtertreibers muss über FilterType - und FilterRunType-Einträge verfügen. Um einen Änderungsfilter anzugeben, definieren Sie den FilterType-Eintrag in Ihrer INF-Datei, wie im folgenden Beispiel gezeigt.

    HKR, Ndi,FilterType,0x00010001 ,0x00000002

    Der FilterType-Wert 0x00000002 gibt an, dass der Filter ein Änderungsfilter ist.

  • Definieren Sie den FilterRunType-Eintrag in Ihrer INF-Datei, wie im folgenden Beispiel gezeigt.

    HKR, Ndi,FilterRunType,0x00010001 ,0x00000001

    Der 0x00000001 Wert im vorherigen Beispiel gibt an, dass das Filtermodul obligatorisch ist. Um ein optionales Filtermodul zu installieren, legen Sie den FilterRunType-Eintrag auf 0x00000002 fest. Weitere Informationen finden Sie unter "Obligatorische Filtertreiber".

  • Das folgende Beispiel zeigt, wie eine ändernde Filtertreiber INF-Datei den Namen des Diensts angibt.

    HKR, Ndi,Service,,"NdisLwf"

    In diesem Beispiel ist „NdisLwf“ der Name des Treiberdienstes, wie er an NDIS gemeldet wird. Beachten Sie, dass sich der Name des Diensts eines Filtertreibers vom Namen der Binärdatei für den Treiber unterscheiden kann– in der Regel sind sie jedoch identisch.

  • Das folgende Beispiel zeigt, wie die FILTER-INF-Datei auf den Namen des Diensts des Filtertreibers verweist, wenn dieser Dienst hinzugefügt wird.

    [Install.Services]
AddService=NdisLwf,,NdisLwf_Service_Inst;, common.EventLog 

[NdisLwf_Service_Inst]
DisplayName     = %NdisLwf_Desc%
ServiceType     = 1 ;SERVICE_KERNEL_DRIVER
StartType       = 1 ;SERVICE_SYSTEM_START
ErrorControl    = 1 ;SERVICE_ERROR_NORMAL
ServiceBinary   = %13%\ndislwf.sys
LoadOrderGroup  = NDIS
Description     = %NdisLwf_Desc%
AddReg          = Common.Params.reg

  • Eine Filter-INF-Datei muss mindestens den primären Dienstnamen des Filters für das CoServices-Attribut angeben, wie im folgenden Beispiel gezeigt.

    HKR, Ndi,CoServices,0x00010000,"NdisLwf"

    Weitere Informationen zum CoServices-Attribut finden Sie unter Hinzufügen von Dienstbezogenen Werten zum Ndi-Schlüssel.

  • Der FilterClass-Wert in der INF-Datei für einen Filtertreiber bestimmt seine Reihenfolge in einem Stapel von Filtern. Filtertreiber müssen den FilterClass-Schlüssel definieren. Die Klasse des Treibers kann einer der Werte in der folgenden Tabelle sein.

    Wert BESCHREIBUNG

    Planer

    Filterdienst zur Paketplanung. Diese Klasse des Filtertreibers ist der Treiber der höchsten Ebene, der über Verschlüsselungsklassenfiltern in einem Treiberstapel vorhanden sein kann. Ein Paketplaner erkennt die 802.1p-Prioritätsklassifizierung, die Paketen durch QoS-Signalkomponenten (Quality of Service) zugewiesen wird, und der Scheduler sendet diese Paketebenen gemäß ihrer Priorität an zugrunde liegende Treiber.

    Verschlüsselung

    Verschlüsselungsklassenfiltertreiber sind zwischen Scheduler- und Komprimierungsklassenfiltern vorhanden.

    Kompression

    Komprimierungsklassenfiltertreiber sind zwischen Verschlüsselungs- und VPN-Klassenfiltern vorhanden.

    VPN

    VPN-Klassenfiltertreiber sind zwischen Komprimierungs- und Lastenausgleichsfiltertreibern vorhanden.

    Lastverteilung

    Filterdienst zum Lastenausgleich. Diese Klasse des Filtertreibers ist zwischen Paketplanung und Failovertreibern vorhanden. Ein Lastenausgleichsfilterdienst gleicht die Workload der Paketübertragungen aus, indem er die Workload über die zugrunde liegenden Miniport-Adapter verteilt.

    failover

    Failover-Filterdienst. Diese Klasse des Filtertreibers ist zwischen Lastenausgleichs- und Diagnosetreibern vorhanden.

    Diagnostik

    Diagnosefiltertreiber sind unterhalb von Failovertreibern im Stapel vorhanden.

    Gewohnheit

    Filtertreiber in der benutzerdefinierten Klasse sind unter Diagnosetreibern vorhanden.

    Anbieteradresse

    Anbieteradressfiltertreiber befinden sich unterhalb des mitgelieferten ms_wnv-Filters der Hyper-V-Netzwerkvirtualisierung und arbeiten mit Anbieteradresspaketen (Provider Address, PA).

Anmerkung Wenn mehrere Filtertreiber über dieselbe Filterklasse verfügen, werden sie alle dem mehrschichtigen Stapel von Filtertreibern hinzugefügt. Das System weist jedem Änderungsfiltertreiber mit derselben Filterklasse eine Schichtreihenfolge zu. In einigen Fällen kann der Systemadministrator die relative Reihenfolge von Filtertreibern mit derselben Filterklasse neu anordnen.

Das folgende Beispiel zeigt ein Beispiel für FilterClass .

HKR, Ndi,FilterClass,, compression

  • Nur Hyper-V-Switch-Erweiterungsfiltertreiber sind im erweiterbaren Switch für Hyper-V gültig. Erweiterbare Hyper-V-Switchfiltertreiber müssen den FilterClass-Schlüssel mit einem der Werte in der folgenden Tabelle definieren.

    Wert BESCHREIBUNG

    ms_switch_capture

    Ab NDIS 6.30 überwachen Capture-Treiber den Paketdatenverkehr im Treiberstapel des erweiterbaren Switch für Hyper-V. Diese Klasse des Filtertreibers ist unter benutzerdefinierten Treibern im Stapel vorhanden.

    Weitere Informationen zu dieser Treiberklasse finden Sie unter Erfassen von Erweiterungen.

    ms_switch_filter

    Ab NDIS 6.30 filtern Filtertreiber den Paketdatenverkehr und setzen Port- oder Switchrichtlinien um, um die Paketübermittlung über den erweiterbaren Switch-Treiberstapel durchzuführen. Diese Klasse des Filtertreibers ist unter ms_switch_capture Treibern im Stapel vorhanden.

    Weitere Informationen zu dieser Treiberklasse finden Sie unter Filtererweiterungen.

    ms_switch_forward

    Ab NDIS 6.30 führen Weiterleitungstreiberfilter dieselben Funktionen wie ein Filtertreiber aus. Weiterleitungstreiber leiten auch Pakete an und von erweiterbaren Switchports weiter. Diese Klasse des Filtertreibers ist unter ms_switch_filter Treibern im Stapel vorhanden.

    Weitere Informationen zu dieser Klasse von Treibern finden Sie unter Erweiterungen für Weiterleitungen.

  • Sie müssen die folgenden Einträge in der INF-Datei des modifizierenden Filtertreibers definieren, um die Treiberbindungen zu steuern.

    HKR, Ndi\Interfaces,UpperRange,,"noupper"
HKR, Ndi\Interfaces,LowerRange,,"nolower"
HKR, Ndi\Interfaces, FilterMediaTypes,,"ethernet"

    Weitere Informationen zum Steuern der Treiberbindungen finden Sie unter Angeben von Bindungsbeziehungen des Filtertreibers.

  • Eine Änderungsfilter-INF-Datei kann allgemeine Parameterdefinitionen für den Treiber und parameter angeben, die einem bestimmten Adapter zugeordnet sind. Das folgende Beispiel zeigt einige allgemeine Parameterdefinitionen.

Vorsicht

Die Verwendung von HKR AddReg , um Schlüssel direkt unter den Dienststatus zu setzen, ist eine Complianceverletzung. Diese Schlüssel müssen unter dem Parameterschlüssel des Diensts hinzugefügt werden, damit er kompatibel ist.

[Common.Params.reg]

HKR, FilterDriverParams\DriverParam,  ParamDesc, , "Driverparam for lwf"
HKR, FilterDriverParams\DriverParam,  default, , "5"
HKR, FilterDriverParams\DriverParam,  type,  , "int"

HKR, FilterAdapterParams\AdapterParam,  ParamDesc, , "Adapterparam for lwf"
HKR, FilterAdapterParams\AdapterParam,  default, , "10"
HKR, FilterAdapterParams\AdapterParam,  type,  , "int"