NdisFRestartFilter 函数 (ndis.h)

  • 项目

筛选器驱动程序调用 NdisFRestartFilter 函数以请求 NDIS 启动筛选器模块的重启操作。

语法

NDIS_STATUS NdisFRestartFilter(
  [in] NDIS_HANDLE NdisFilterHandle
);

参数

[in] NdisFilterHandle

标识此筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。

返回值

NdisFRestartFilter 返回以下状态值之一：

返回代码 说明
NDIS_STATUS_SUCCESS

如果 NdisFRestartFilter 已启动重启操作，则返回NDIS_STATUS_SUCCESS。
NDIS_STATUS_RESOURCES

NdisFRestartFilter 由于资源不足而失败。
NDIS_STATUS_FAILURE

如果上述值均未应用，则 NdisFRestartFilter 返回NDIS_STATUS_FAILURE。

注解

筛选器驱动程序可以通过调用 NdisFRestartFilter 函数在运行时更改筛选器模块属性。 NdisFRestartFilter 为指定的筛选器模块计划暂停和重启操作。

在 NDIS 重启筛选器模块之前，它会为筛选器模块调用 FilterSetModuleOptions 函数。 从 FilterSetModuleOptions 函数中，筛选器驱动程序可以通过调用 NdisSetOptionalHandlers 函数并指定一组新的处理程序来更改该筛选器模块的数据处理程序。

要求

要求 值
最低受支持的客户端 在 NDIS 6.0 及更高版本中受支持。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_Filter_Driver_Function (ndis)

另请参阅

FilterAttach

FilterSetModuleOptions

NdisSetOptionalHandlers