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)
Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_Filter_Driver_Function(ndis)

另请参阅

FilterAttach

FilterSetModuleOptions

NdisSetOptionalHandlers