Acessando informações de configuração para um driver de filtro
O NDIS dá suporte a um conjunto de funções que fornecem acesso a parâmetros de registro de driver de filtro. Os drivers de filtro podem acessar esses parâmetros durante as operações de anexação ou reinicialização ou quando estão processando uma notificação de Plug and Play (PnP). Para obter mais informações sobre notificações PnP, consulte Filtrar notificações de evento PnP do módulo. Para obter mais informações sobre como anexar um módulo de filtro, consulte Anexando um módulo de filtro. Para obter mais informações sobre operações de reinicialização, consulte Iniciando um módulo de filtro.
Os drivers de filtro chamam a função NdisOpenConfigurationEx para acessar as configurações do Registro. Se um driver de filtro obteve o identificador no membro NdisHandle da estrutura NDIS_CONFIGURATION_OBJECT chamando a função NdisFRegisterFilterDriver , a função NdisOpenConfigurationEx fornece um identificador para o local do registro em que os parâmetros de configuração do driver de filtro são armazenados. Os drivers de filtro podem usar o identificador de configuração até que chamem a função NdisFDeregisterFilterDriver .
Se um driver de filtro obteve o identificador em NdisHandle do parâmetro NdisFilterHandle da função FilterAttach , NdisOpenConfigurationEx fornece um identificador para o local do registro em que os parâmetros de configuração de um módulo de filtro são armazenados. O driver de filtro pode usar o identificador de configuração até que o NDIS desanexe o módulo de filtro e a função FilterDetach retorne. Se um driver de filtro de monitoramento especificar o sinalizador NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION no membro Flags da estrutura NDIS_CONFIGURATION_OBJECT , o driver poderá acessar a configuração do módulo de filtro para um módulo de filtro específico quando houver vários módulos de filtro configurados no mesmo adaptador de miniport. A modificação de drivers de filtro não deve usar esse sinalizador.
Depois que um driver terminar de acessar as informações de configuração, o driver deverá chamar a função NdisCloseConfiguration para liberar o identificador de configuração e os recursos relacionados.