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) |
程式庫 | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | Irql_Filter_Driver_Function (ndis) |