访问筛选器驱动程序的配置信息
NDIS 支持一组函数,这些函数提供对筛选器驱动程序注册表参数的访问权限。 筛选器驱动程序可以在附加或重启操作期间或在处理即插即用 (PnP) 通知时访问这些参数。 有关 PnP 通知的详细信息,请参阅 筛选模块 PnP 事件通知。 有关附加筛选器模块的详细信息,请参阅 附加筛选器模块。 有关重启操作的详细信息,请参阅 启动筛选器模块。
筛选器驱动程序调用 NdisOpenConfigurationEx 函数来访问注册表设置。 如果筛选器驱动程序通过调用 NdisFRegisterFilterDriver 函数获取了 NDIS_CONFIGURATION_OBJECT 结构的 NdisHandle 成员中的句柄,则 NdisOpenConfigurationEx 函数将提供存储筛选器驱动程序配置参数的注册表位置的句柄。 筛选器驱动程序可以使用配置句柄,直到调用 NdisFDeregisterFilterDriver 函数。
如果筛选器驱动程序从 FilterAttach 函数的 NdisFilterHandle 参数中获取了 NdisHandle 中的句柄,则 NdisOpenConfigurationEx 提供存储筛选器模块配置参数的注册表位置的句柄。 筛选器驱动程序可以使用配置句柄,直到 NDIS 分离筛选器模块并且 FilterDetach 函数返回。 如果监视筛选器驱动程序在 NDIS_CONFIGURATION_OBJECT 结构的 Flags 成员中指定 NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION 标志,则当在同一微型端口适配器上配置多个筛选器模块时,驱动程序可以访问特定筛选器模块的筛选器模块配置。 修改筛选器驱动程序不得使用此标志。
驱动程序访问配置信息后,驱动程序必须调用 NdisCloseConfiguration 函数来释放配置句柄和相关资源。