共用方式為


NdisFRestartFilter 函式 (ndis.h)

篩選驅動程式會呼叫 NdisFRestartFilter 函式,以要求 NDIS 起始篩選模組的重新啟動作業。

語法

NDIS_STATUS NdisFRestartFilter(
  [in] NDIS_HANDLE NdisFilterHandle
);

參數

[in] NdisFilterHandle

識別此篩選模組的 NDIS 句柄。 NDIS 在對 FilterAttach 函式的呼叫中,將句柄傳遞至篩選驅動程式。

傳回值

NdisFRestartFilter 會傳回下列其中一個狀態值:

傳回碼 Description
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