Szűrőmodul csatolása

A szűrőmodul illesztőprogram-verembe való beszúrásának elindításához az NDIS meghívja a szűrőillesztő FilterAttach függvényét. A FilterAttach függvény végrehajtásának kezdetén a szűrőmodul a Csatolás állapotba kerül. A szűrőmodul illesztőprogram-veremhez való csatolásáról további információt az Illesztőprogram-verem indítása című témakörben talál.

A szűrőillesztők a szűrőmodulra hivatkozó összes jövőbeli NdisXxx függvényhívásban a FilterAttachNdisFilterHandle paraméterén áthaladó leírót használják. Ilyen függvények például az állapotjelzők, a kérések küldése, a jelzés fogadása és az OID-kérések.

Míg egy szűrőmodul csatolási állapotban van, az illesztőprogram:

• Létrehoz egy környezeti területet a szűrőmodulhoz, és pufferkészleteket és más szűrőmodul-specifikus erőforrásokat foglal le. További információ a pufferkészletekről: Szűrőillesztő pufferkezelése.

• Meghívja a NdisFSetAttributesfüggvényt a FilterAttachnak átadott NdisFilterHandle érték használatával. Az NdisFSetAttributesFilterModuleContext paramétere határozza meg a szűrőillesztő környezetét ehhez a szűrőmodulhoz. Az NDIS átadja ezt a környezeti területet a szűrőillesztő FilterXxx függvényeinek.

• Opcionálisan beolvassa a szűrőmodul konfigurációs paramétereit a beállításjegyzékből. További információ: Szűrőillesztő konfigurációs adatainak elérése.

• Ha az előző műveletek sikeresen befejeződtek, a szűrőmodul szüneteltetett állapotban van.

• Ha az előző műveletek sikertelenek, a szűrőillesztőnek fel kell szabadítania a FilterAttach függvényben lefoglalt erőforrásokat, és vissza kell adnia a szűrőmodult a Leválasztott állapotba.

• NDIS_STATUS_SUCCESS vagy egy megfelelő hibakódot ad vissza. Ha az illesztőprogram hibakódot ad vissza, az NDIS leállítja az illesztőprogram-vermet.

Jegyzet A beállításjegyzék tartalmazhat egy jelzőt, amely meghatározza, hogy a szűrőmodul nem kötelező. Ha egy választható szűrőmodul nem csatlakozik, az NDIS nem zárja le az illesztőprogram-verem többi részét.

A szűrőillesztők nem küldhetnek kéréseket, nem jelezhetők fogadott adatok, nem lehet OID-kéréseket küldeni, vagy állapotjelzéseket küldeni a csatolási állapotból. A küldési és fogadási műveletek futási és szüneteltetési állapotban támogatottak. Az OID-kérelmek és állapotjelzők támogatottak a szüneteltetett, az újraindítás, a futtatás és a szüneteltetés állapotában .

Az NDIS meghívja a FilterDetach függvényt egy szűrőmodul leválasztására, amelyet az NDIS a FilterAttachhoz csatolt. További információ: Szűrőmodul leválasztása.