Accès aux informations de configuration d’un pilote de filtre

NDIS prend en charge un ensemble de fonctions qui fournissent l’accès aux paramètres de registre de pilotes de filtre. Les pilotes de filtre peuvent accéder à ces paramètres pendant les opérations d’attachement ou de redémarrage ou lorsqu’ils traitent une notification de Plug-and-Play (PnP). Pour plus d’informations sur les notifications PnP, consultez Filtrer les notifications d’événements PnP du module. Pour plus d’informations sur l’attachement d’un module de filtre, consultez Attachement d’un module de filtre. Pour plus d’informations sur les opérations de redémarrage, consultez Démarrage d’un module de filtre.

Les pilotes de filtre appellent la fonction NdisOpenConfigurationEx pour accéder aux paramètres du Registre. Si un pilote de filtre a obtenu le handle dans le membre NdisHandle de la structure NDIS_CONFIGURATION_OBJECT en appelant la fonction NdisFRegisterFilterDriver , la fonction NdisOpenConfigurationEx fournit un handle à l’emplacement du Registre où sont stockés les paramètres de configuration du pilote de filtre. Les pilotes de filtre peuvent utiliser le handle de configuration jusqu’à ce qu’ils appellent la fonction NdisFDeregisterFilterDriver .

Si un pilote de filtre a obtenu le handle dans NdisHandle à partir du paramètre NdisFilterHandle de la fonction FilterAttach , NdisOpenConfigurationEx fournit un handle à l’emplacement du Registre où sont stockés les paramètres de configuration d’un module de filtre. Le pilote de filtre peut utiliser le handle de configuration jusqu’à ce que NDIS détache le module de filtre et que la fonction FilterDetach retourne. Si un pilote de filtre de surveillance spécifie l’indicateur NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION dans le membre Indicateurs de la structure NDIS_CONFIGURATION_OBJECT , le pilote peut accéder à la configuration du module de filtre pour un module de filtre spécifique lorsqu’il existe plusieurs modules de filtre configurés sur le même adaptateur miniport. La modification des pilotes de filtre ne doit pas utiliser cet indicateur.

Une fois qu’un pilote a terminé d’accéder aux informations de configuration, il doit appeler la fonction NdisCloseConfiguration pour libérer le handle de configuration et les ressources associées.