Acessando informações de configuração para um driver de filtro

O NDIS suporta 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 Plug and Play (PnP). Para obter mais informações sobre notificações PnP, consulte Filter Module PnP Event Notifications. 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 ao chamar a função NdisFRegisterFilterDriver, a função NdisOpenConfigurationEx fornece um identificador para a localização no registo onde 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 a alça em NdisHandle a partir do parâmetro NdisFilterHandle da função FilterAttach, NdisOpenConfigurationEx fornece uma alça para a localização no registo 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 Flags membro 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. Drivers de filtro modificados não devem usar este sinalizador.

Depois que um driver termina 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.