NdisFRestartFilter 函数 (ndis.h)
筛选器驱动程序调用 NdisFRestartFilter 函数以请求 NDIS 启动筛选器模块的重启操作。
语法
NDIS_STATUS NdisFRestartFilter(
[in] NDIS_HANDLE NdisFilterHandle
);
参数
[in] NdisFilterHandle
标识此筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。
返回值
NdisFRestartFilter 返回以下状态值之一:
返回代码 | 说明 |
---|---|
|
如果 NdisFRestartFilter 已启动重启操作,则返回NDIS_STATUS_SUCCESS。 |
|
NdisFRestartFilter 由于资源不足而失败。 |
|
如果上述值均未应用,则 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) |