Konfigurera en INF-fil för en ändringsfilterdrivrutin

Följande problem med installation av NDIS-filterdrivrutiner är associerade med ändring av filterdrivrutiner. Om du vill skapa en egen INF-fil för filtreringsdrivrutinen kan du också anpassa exempel på NDIS 6.0-filterdrivrutinen.

• Ställ in Class-INF-inmatningen till NetService i INF-filen. I följande exempel visas en -klass-post för INF-filen.

  Class = NetService
  

• Avsnittet DDInstall i en INF-fil för filterdrivrutinen måste ha posten Egenskaper. I följande exempel visas hur du ska definiera posten Egenskaper i inf-filen för filtret.

  Characteristics=0x40000
  

  Värdet 0x40000 anger att NCF_LW_FILTER (0x40000) har angetts. Filterdrivrutiner får inte ange flaggan NCF_FILTER (0x400). Värdena för flaggorna NCF_ Xxx definieras i Netcfgx.h. För mer information om NCF_ Xxx-flaggor, se avsnittet DDInstall i en nätverks-Inf-fil.

• Ange NetCfgInstanceId som en INF-filpost i INF-filen, vilket visas i följande exempel.

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

  Du kan använda verktyget Uuidgen.exe för att skapa GUID för posten NetCfgInstanceId.

• Avsnittet DDInstall i INF-filen för en filterdrivrutin måste innehålla ett Addreg-direktiv för en Ndi-nyckel. INF-filen måste ange posten Service under nyckeln Ndi. Posten ServiceBinary i avsnittet service-install i INF-filen anger sökvägen till binärfilen för filterdrivrutinen. För mer information, se Lägg till tjänstrelaterade värden till Ndi Key och DDInstall.Services-avsnittet i en nätverks-INF-fil.

• Avsnittet DDInstall i en INF-fil för en filterdrivrutin måste ha posterna FilterType- och FilterRunType-. Om du vill ange ett ändringsfilter definierar du posten FilterType i INF-filen, vilket visas i följande exempel.

  HKR, Ndi,FilterType,0x00010001 ,0x00000002
  

  Värdet FilterType 0x00000002 anger att filtret är ett ändringsfilter.

• Definiera posten FilterRunType i INF-filen, vilket visas i följande exempel.

  HKR, Ndi,FilterRunType,0x00010001 ,0x00000001
  

  Värdet 0x00000001 i föregående exempel anger att filtermodulen är obligatorisk. Om du vill installera en valfri filtermodul anger du posten FilterRunType till 0x00000002. Mer information finns i Obligatoriska Filterdrivrutiner.

• I följande exempel visas hur en inf-fil för att ändra filterdrivrutinen anger namnet på tjänsten.

  HKR, Ndi,Service,,"NdisLwf"
  

  I det här exemplet är NdisLwf namnet på driverns tjänst som den rapporteras till NDIS. Observera att namnet på en filterdrivrutinstjänst kan skilja sig från namnet på binärfilen för drivrutinen , men vanligtvis är de desamma.

• I följande exempel visas hur filtrets INF-fil refererar till namnet på filterdrivrutinens tjänst när den lägger till tjänsten.

  [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
  

• En INF-filterfil måste ange minst det primära tjänstnamnet för filtret för attributet CoServices, vilket visas i följande exempel.

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

  För mer information om attributet CoServices, se Att lägga till tjänstrelaterade värden i Ndi Key.

• Värdet FilterClass i INF-filen för en filterdrivrutin avgör dess ordning i en uppsättning filter. Filterdrivrutiner måste definiera nyckeln FilterClass. Drivrutinsklassen kan vara ett av värdena i följande tabell.

  Värde	Beskrivning
  schemaläggare	Filtreringstjänst för paketschemaläggning. Den här klassen av filterdrivrutin är den högsta drivrutinen som kan finnas ovanför krypteringsklassfilter i en drivrutinsstack. En paketschemaläggare identifierar prioritetsklassificeringen 802.1p som ges till paket efter QoS-signalkomponenter (Quality of Service) och schemaläggaren skickar paketnivåerna till underliggande drivrutiner enligt deras prioritet.
  kryptering	Filterdrivrutiner för krypteringsklass finns mellan filter för schemaläggningsklassen och komprimeringsklassen.
  komprimering	Filterdrivrutiner för komprimeringsklass finns mellan krypterings- och VPN-klassfilter.
  VPN	VPN-klassfilterdrivrutiner placeras mellan komprimerings- och belastningsutjämningsfilterdrivrutiner.
  belastningsbalansering	Tjänst för belastningsutjämningsfilter. Den här klassen med filterdrivrutiner finns mellan paketschemaläggning och redundansdrivrutiner. En belastningsutjämningsfiltertjänst balanserar sin arbetsbelastning av paketöverföringar genom att distribuera arbetsbelastningen över sin uppsättning av underliggande miniportadaptrar.
  failover	Tjänst för failover-filtrering. Den här klassen av filterdrivrutiner finns mellan lastbalans- och diagnostikdrivrutiner.
  diagnostik	Diagnostikfilterdrivrutiner finns under redundansdrivrutiner i stacken.
  anpassad	Filterdrivrutiner i anpassad klass finns under diagnostikdrivrutiner.
  leverantörsadress	Drivrutiner för provider address-filter finns under nätverksvirtualisering ms_wnv-filtrets Hyper-V-nivå och arbetar med provider address-paket (PA-paket).

Obs Om flera filterdrivrutiner har samma FilterClass läggs alla till i den skiktade stacken med filterdrivrutiner. Systemet tilldelar en lagerordning till varje ändringsfilterdrivrutin med samma FilterClass. I vissa fall kan systemadministratören ordna om den relativa ordningen för filterdrivrutiner som har samma FilterClass.

I följande exempel visas ett exempel FilterClass .

HKR, Ndi,FilterClass,, compression

• Endast Hyper-V filterdrivrutiner för switchtillägget är giltiga i Hyper-V Extensibel Switch. Hyper-V utökningsbara växelfilterdrivrutiner måste definiera FilterClass-nyckeln med något av värdena i följande tabell.

  Värde	Beskrivning
  ms_switch_capture	Från och med NDIS 6.30 övervakar fångstdrivrutiner pakettrafik i den utbyggbara växeldrivrutinsstacken Hyper-V. Den här klassen med filterdrivrutiner finns under anpassade drivrutiner i stacken. För mer information om den här drivertypen, se Infångande tillägg.
  ms_switch_filter	Från och med NDIS 6.30 filtrerar filtreringsdrivrutiner pakettrafik och tillämpar port- eller växelpolicy för paketleverans via den utbyggbara växeldrivrutinsstacken. Den här klassen av filterdrivrutiner ligger under ms_switch_capture drivrutiner i drivrutinsstacken. Mer information om den här drivrutinsklassen finns i Filtering Extensions.
  ms_växla_från	Från och med NDIS 6.30 utför vidarebefordrande drivrutinsfilter samma funktioner som en filtreringsdrivrutin. Vidarebefordrande drivrutiner vidarebefordrar även paket till och från utökningsbara växelportar. Den här klassen av filterdrivrutin finns nedan ms_switch_filter drivrutiner i stacken. För mer information om den här drivrutinsklassen, se Vidarebefordringstillägg.

• Du måste definiera följande poster i INF-filen för filtreringsdrivrutinen för att styra drivrutinsbindningarna.

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

  Mer information om hur du styr drivrutinsbindningar finns i Ange bindningsrelationer för filterdrivrutiner.

• En INF-fil för ett ändringsfilter kan ange vanliga parametrar och deras definitioner för drivrutinen samt parametrarna som är associerade med en specifik adapter. I följande exempel visas några vanliga parameterdefinitioner.

Försiktighet

Att använda HKR AddReg för att placera nycklar direkt under servicestatus är ett brott mot efterlevnadsreglerna. Dessa nycklar måste läggas till under parameternyckeln för tjänsten för att vara kompatibla.

[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"