Zugreifen auf Konfigurationsinformationen für einen Filtertreiber

NDIS unterstützt eine Reihe von Funktionen, die den Zugriff auf Filtertreiberregistrierungsparameter ermöglichen. Filtertreiber können während der Anfügungs- oder Neustartvorgänge oder beim Verarbeiten einer PnP-Benachrichtigung (Plug & Play) auf diese Parameter zugreifen. Weitere Informationen zu PnP-Benachrichtigungen finden Sie unter Filter Module PnP-Ereignisbenachrichtigungen. Weitere Informationen zum Anfügen eines Filtermoduls finden Sie unter Anfügen eines Filtermoduls. Weitere Informationen zu Neustartvorgängen finden Sie unter Starten eines Filtermoduls.

Filtertreiber rufen die Funktion NdisOpenConfigurationEx auf, um auf die Registrierungseinstellungen zuzugreifen. Wenn ein Filtertreiber das Handle im NdisHandle-Member der NDIS_CONFIGURATION_OBJECT-Struktur durch Aufrufen der NdisFRegisterFilterDriver-Funktion abgerufen hat, stellt die NdisOpenConfigurationEx-Funktion ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter des Filtertreibers gespeichert sind. Filtertreiber können das Konfigurationshandle verwenden, bis sie die Funktion NdisFDeregisterFilterDriver aufrufen.

Wenn ein Filtertreiber das Handle in NdisHandle aus dem NdisFilterHandle-Parameter der FilterAttach-Funktion abgerufen hat, stellt NdisOpenConfigurationEx ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter eines Filtermoduls gespeichert sind. Der Filtertreiber kann das Konfigurationshandle verwenden, bis NDIS das Filtermodul trennt und die FilterDetach-Funktion zurückgibt. Wenn ein Überwachungsfiltertreiber das NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION Flag im Flags-Member der NDIS_CONFIGURATION_OBJECT-Struktur angibt, kann der Treiber auf die Filtermodulkonfiguration für ein bestimmtes Filtermodul zugreifen, wenn mehrere Filtermodule über denselben Miniportadapter konfiguriert sind. Beim Ändern von Filtertreibern darf dieses Flag nicht verwendet werden.

Nachdem ein Treiber auf die Konfigurationsinformationen zugegriffen hat, muss der Treiber die NdisCloseConfiguration-Funktion aufrufen, um das Konfigurationshandle und die zugehörigen Ressourcen freizugeben.