Accesso alle informazioni di configurazione per un driver di filtro
NDIS supporta un set di funzioni che forniscono l'accesso ai parametri del Registro di sistema dei driver di filtro. I driver di filtro possono accedere a questi parametri durante le operazioni di collegamento o riavvio o quando elaborano una notifica Plug and Play (PnP). Per altre informazioni sulle notifiche PnP, vedere Filter Module PnP Event Notifications (Filtra notifiche evento PnP PnP). Per altre informazioni sul collegamento di un modulo di filtro, vedere Collegamento di un modulo filtro. Per altre informazioni sulle operazioni di riavvio, vedere Avvio di un modulo filtro.
I driver di filtro chiamano la funzione NdisOpenConfigurationEx per accedere alle impostazioni del Registro di sistema. Se un driver di filtro ha ottenuto l'handle nel membro NdisHandle della struttura NDIS_CONFIGURATION_OBJECT chiamando la funzione NdisFRegisterFilterDriver , la funzione NdisOpenConfigurationEx fornisce un handle al percorso del Registro di sistema in cui vengono archiviati i parametri di configurazione del driver di filtro. I driver di filtro possono usare l'handle di configurazione finché non chiamano la funzione NdisFDeregisterFilterDriver .
Se un driver di filtro ha ottenuto l'handle in NdisHandle dal parametro NdisFilterHandle della funzione FilterAttach, NdisOpenConfigurationEx fornisce un handle al percorso del Registro di sistema in cui vengono archiviati i parametri di configurazione di un modulo di filtro. Il driver di filtro può usare l'handle di configurazione fino a quando NDIS scollega il modulo di filtro e la funzione FilterDetach restituisce. Se un driver di filtro di monitoraggio specifica il flag NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION nel membro Flag della struttura NDIS_CONFIGURATION_OBJECT, il driver può accedere alla configurazione del modulo di filtro per un modulo di filtro specifico quando sono presenti più moduli di filtro configurati sulla stessa scheda miniport. La modifica dei driver di filtro non deve usare questo flag.
Dopo aver eseguito l'accesso alle informazioni di configurazione, il driver deve chiamare la funzione NdisCloseConfiguration per rilasciare l'handle di configurazione e le risorse correlate.