NdisFRestartComplete 函数 (ndis.h)
如果驱动程序从 FilterRestart 函数返回NDIS_STATUS_PENDING,筛选器驱动程序必须调用 NdisFRestartComplete 函数来完成重启操作。
语法
void NdisFRestartComplete(
[in] NDIS_HANDLE NdisFilterHandle,
[in] NDIS_STATUS Status
);
参数
[in] NdisFilterHandle
标识此筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。
[in] Status
重启操作的最终状态。 支持以下状态值:
NDIS_STATUS_SUCCESS
驱动程序已成功重启网络数据流。
NDIS_STATUS_RESOURCES
由于资源不足,重启失败。
NDIS_STATUS_FAILURE
如果上述值均未应用,驱动程序将指示NDIS_STATUS_FAILURE。 驱动程序应将 NdisWriteEventLogEntry 函数与指定失败原因的参数一起调用。
返回值
无
备注
NDIS 调用筛选器驱动程序的 FilterRestart 函数来启动筛选器模块的重启请求。 筛选器模块将保持“ 正在重启” 状态,直到重启操作完成。
驱动程序调用 NdisFRestartComplete 函数后,将完成挂起的重启操作。 重启操作完成后,筛选器模块处于 “正在运行” 状态。
筛选器驱动程序可以恢复,指示在 NDIS 调用 FilterRestart 之后和驱动程序调用 NdisFRestartComplete 之前立即收到网络数据。 驱动程序应在完成重启操作后准备好接受发送请求。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 NDIS 6.0 及更高版本中受支持。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
Library | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | Irql_Filter_Driver_Function (ndis) |