Obtener acceso a la información de configuración de un controlador de filtro
NDIS admite un conjunto de funciones que proporcionan acceso a los parámetros del registro del controlador de filtro. Los controladores de filtro pueden acceder a estos parámetros durante las operaciones de asociación o reinicio, o cuando procesan una notificación de Plug and Play (PnP). Para obtener más información sobre las notificaciones de PnP, consulte Filtrar Notificaciones de eventos PnP del módulo. Para obtener más información sobre cómo adjuntar un módulo de filtro, vea Adjuntar un módulo de filtro. Para obtener más información sobre las operaciones de reinicio, consulte Inicio de un módulo de filtro.
Los controladores de filtro llaman a la función NdisOpenConfigurationEx para acceder a la configuración del Registro. Si un controlador de filtro obtuvo el identificador en el miembro NdisHandle de la estructura NDIS_CONFIGURATION_OBJECT llamando a la función NdisFRegisterFilterDriver , la función NdisOpenConfigurationEx proporciona un identificador a la ubicación del Registro donde se almacenan los parámetros de configuración del controlador de filtro. Los controladores de filtro pueden usar el identificador de configuración hasta que llamen a la función NdisFDeregisterFilterDriver .
Si un controlador de filtro obtuvo el identificador en NdisHandle del parámetro NdisFilterHandle de la función FilterAttach , NdisOpenConfigurationEx proporciona un identificador a la ubicación del Registro donde se almacenan los parámetros de configuración de un módulo de filtro. El controlador de filtro puede usar el identificador de configuración hasta que NDIS desasocie el módulo de filtro y la función FilterDetach devuelva. Si un controlador de filtro de supervisión especifica la marca NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION en el miembro Flags de la estructura de NDIS_CONFIGURATION_OBJECT , el controlador puede acceder a la configuración del módulo de filtro para un módulo de filtro específico cuando hay varios módulos de filtro configurados en el mismo adaptador de miniporte. La modificación de los controladores de filtro no debe usar esta marca.
Una vez que un controlador haya terminado de acceder a la información de configuración, el controlador debe llamar a la función NdisCloseConfiguration para liberar el identificador de configuración y los recursos relacionados.