Wskazówki dotyczące przenoszenia starszych sterowników filtrów

Deweloperzy są zachęcani do przenoszenia starszych sterowników filtrów do modelu menedżera filtrów, aby uzyskać lepsze funkcje sterowników filtrów i zwiększyć niezawodność systemu. Doświadczeni deweloperzy powinni uznać to za stosunkowo łatwe, aby przeportować stary sterownik filtru do sterownika minifiltru. Deweloperzy sterowników filtrów w firmie Microsoft zalecają następujące podejście:

• Zacznij od niezawodnego zestawu testów regresji, aby zweryfikować zachowanie starszego sterownika filtru i sterownika minifiltru portowego.

• Utwórz powłokę sterownika minifiltru i systematyczne przenoszenie funkcji ze starszego sterownika filtru do sterownika minifiltru. Na przykład, uruchom działanie załącznika, a następnie przenoś jedną operację na raz, testując po każdej operacji.

• Zmień komunikację w trybie użytkownika/trybie jądra na końcu, aby móc użyć istniejących narzędzi do przetestowania sterownika minifiltru.

• Skompiluj z użyciem PREfast i przetestuj, włączając opcję weryfikacji I/O w Weryfikatorze filtra w Weryfikatorze sterownika.

Podczas procesu przenoszenia należy przejrzeć cały starszy kod sterownika filtru, aby w pełni wykorzystać możliwości menedżera filtrów. W szczególności należy pamiętać o następujących kwestiach:

• Operacje we/wy oparte na IRP i szybkie operacje we/wy mogą być realizowane w ramach tej samej operacji, gdy to odpowiednie, co pomaga zmniejszyć duplikację kodu.

• Podczas rejestrowania operacji sterownik minifiltru może jawnie zignorować wszystkie operacje wejścia/wyjścia związane ze stronicowaniem i buforowaniem, co eliminuje potrzebę sprawdzania kodu.

• Powiadomienia o wystąpieniach znacznie upraszczają logikę dołączania/odłączania.

• Zarejestruj się tylko w przypadku operacji, które musi obsługiwać sterownik minifiltru; możesz zignorować wszystkie inne elementy.

• Skorzystaj z obsługi zarządzania kontekstami i nazwami menedżera filtrów.

• Skorzystaj z obsługi menedżera filtrów do realizowania nierekurencyjnych operacji we/wy.

• W przeciwieństwie do starszych sterowników filtrów sterowniki minifiltrów nie mogą polegać na zmiennych lokalnych w celu zachowania kontekstu od przetwarzania wstępnego do przetwarzania pooperacyjnego. Rozważ przydzielenie listy lookaside do przechowywania stanu operacji.

• Pamiętaj, aby zwolnić odwołania po zakończeniu korzystania z nazwy lub kontekstu.

• Porty kompletacji w trybie użytkownika dodają zaawansowaną technikę tworzenia kolejek. Prawdopodobnie będzie potrzebne tylko jedno połączenie z jednym nazwanym portem.

W poniższej tabeli wymieniono typowe operacje w starszym sterowniku filtru i sposób mapowania ich na model menedżera filtrów.