Sdílet prostřednictvím

Připojení modulu filtru

  • Článek

Chcete-li zahájit proces vložení modulu filtru do zásobníku ovladačů, NDIS volá funkci ovladače filtru FilterAttach. Na začátku provádění ve funkci FilterAttach modul filtru zadá stav Attaching. Další informace o připojení modulu filtru ke driver stacku najdete v tématu Spuštění driver stacku.

Ovladač filtru používá popisovač, který NDIS předává v parametru NdisFilterHandle u FilterAttach ve všech budoucích funkcích NdisXxx, které odkazují na tento modul filtru. Mezi tyto funkce patří indikace stavu, odesílání požadavků, příjem indikací a požadavky OID.

Zatímco se modul filtru nachází ve stavu Připojení , ovladač:

  • Vytvoří kontextovou oblast pro modul filtru a přidělí fondy vyrovnávací paměti a další prostředky specifické pro modul filtru. Další informace o fondech vyrovnávacích pamětí naleznete v tématu Správa vyrovnávací paměti ovladače filtru.

  • Volá funkci NdisFSetAttributes pomocí hodnoty NdisFilterHandle, kterou NDIS předal FilterAttach. Parametr FilterModuleContextNdisFSetAttributes určuje kontextovou oblast ovladače filtru pro tento modul filtru. NDIS předá tuto kontextovou oblast do funkcí filtru FilterXxx.

  • Volitelně můžete číst parametry konfigurace pro tento modul filtru z registru. Další informace naleznete v tématu Přístup ke konfiguračním informacím pro ovladač filtru.

  • Pokud se předchozí operace úspěšně dokončily, modul filtru je ve stavu Pozastaveno.

  • Pokud předchozí operace selhaly, ovladač filtru musí uvolnit všechny prostředky přidělené ve funkci FilterAttach a vrátit modul filtru do stavu Odpojeno.

  • Vrátí NDIS_STATUS_SUCCESS nebo odpovídající kód selhání. Pokud ovladač vrátí kód selhání, rozhraní NDIS ukončí zásobník ovladačů.

Poznámka Registr může obsahovat příznak, který určuje, že modul filtru je volitelný. Pokud se volitelný modul filtru nepřipojí, NDIS neukončí zbytek ovladačového zásobníku.

Ovladač filtru nemůže odesílat požadavky, indikovat přijatá data, provádět požadavky OID nebo indikovat stav ze stavu Připojování. Operace odesílání a příjmu jsou podporovány ve stavech Běh a Pozastavení. OID požadavky a indikace stavu jsou podporovány ve stavech pozastavených, restartování, spuštěnýcha pozastavení.

NDIS volá funkci FilterDetach pro odpojení modulu filtru, který NDIS připojil pomocí FilterAttach. Další informace najdete v tématu Odpojení modulu filtru.