NdisFRestartFilter 函式 (ndis.h)
篩選驅動程式會呼叫 NdisFRestartFilter 函式,以要求 NDIS 起始篩選模組的重新啟動作業。
語法
NDIS_STATUS NdisFRestartFilter(
[in] NDIS_HANDLE NdisFilterHandle
);
參數
[in] NdisFilterHandle
識別此篩選模組的 NDIS 句柄。 NDIS 在對 FilterAttach 函式的呼叫中,將句柄傳遞至篩選驅動程式。
傳回值
NdisFRestartFilter 會傳回下列其中一個狀態值:
傳回碼 | Description |
---|---|
|
NdisFRestartFilter 會在啟動重新啟動作業時傳回NDIS_STATUS_SUCCESS。 |
|
NdisFRestartFilter 因為資源不足而失敗。 |
|
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) |