Доступ к сведениям о конфигурации для драйвера фильтра

NDIS поддерживает набор функций, которые предоставляют доступ для фильтрации параметров реестра драйверов. Драйверы фильтров могут обращаться к этим параметрам во время операций присоединения или перезапуска или при обработке уведомления Plug and Play (PnP). Дополнительные сведения об уведомлениях PnP см. в разделе Уведомления о событиях PnP модуля фильтрации. Дополнительные сведения о присоединении модуля фильтра см. в разделе Присоединение модуля фильтра. Дополнительные сведения об операциях перезапуска см. в разделе Запуск модуля фильтра.

Драйверы фильтров вызывают функцию NdisOpenConfigurationEx для доступа к параметрам реестра. Если драйвер фильтра получил дескриптор в элементе NdisHandleструктуры NDIS_CONFIGURATION_OBJECT путем вызова функции NdisFRegisterFilterDriver , функция NdisOpenConfigurationEx предоставляет дескриптор для расположения реестра, в котором хранятся параметры конфигурации драйвера фильтра. Драйверы фильтров могут использовать дескриптор конфигурации до тех пор, пока они не вызовут функцию NdisFDeregisterFilterDriver .

Если драйвер фильтра получил дескриптор в NdisHandle из параметра NdisFilterHandle функции FilterAttach , NdisOpenConfigurationEx предоставляет дескриптор для расположения реестра, в котором хранятся параметры конфигурации модуля фильтра. Драйвер фильтра может использовать дескриптор конфигурации, пока NDIS не отсоединит модуль фильтра и не будет возвращена функция FilterDetach . Если драйвер фильтра мониторинга указывает флаг NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION в элементе Flags структуры NDIS_CONFIGURATION_OBJECT , драйвер может получить доступ к конфигурации модуля фильтра для определенного модуля фильтра при наличии нескольких модулей фильтра, настроенных для одного адаптера минипорта. При изменении драйверов фильтров этот флаг не должен использоваться.

После завершения доступа к сведениям о конфигурации драйвер должен вызвать функцию NdisCloseConfiguration , чтобы освободить дескриптор конфигурации и связанные ресурсы.