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