Acessando informações de configuração para um driver de filtro
O NDIS dá suporte a um conjunto de funções que fornecem acesso aos parâmetros de registro do 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 PnP (Plug and Play). Para obter mais informações sobre notificações PnP, consulte Notificações de eventos PnP do módulo de filtro. 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é chamarem a função NdisFDeregisterFilterDriver.
Se um driver de filtro obteve o identificador no NdisHandle a partir do parâmetro NdisFilterHandle da função FilterAttach, NdisOpenConfigurationEx proporcionará um identificador para o local do registro onde estão armazenados os parâmetros de configuração de um módulo de filtro. 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 Sinalizadores 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 miniporta. 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 deve chamar a função NdisCloseConfiguration para liberar o identificador de configuração e os recursos relacionados.