NdisFRestartFilter function (ndis.h)

Article
04/18/2022

A filter driver calls the NdisFRestartFilter function to request NDIS to initiate a restart operation for a filter module.

Syntax

NDIS_STATUS NdisFRestartFilter(
  [in] NDIS_HANDLE NdisFilterHandle
);

Parameters

[in] NdisFilterHandle

The NDIS handle that identifies this filter module. NDIS passed the handle to the filter driver in a call to the FilterAttach function.

Return value

NdisFRestartFilter returns one of the following status values:

Return code	Description
NDIS_STATUS_SUCCESS	NdisFRestartFilter returns NDIS_STATUS_SUCCESS if it started the restart operation.
NDIS_STATUS_RESOURCES	NdisFRestartFilter failed because of insufficient resources.
NDIS_STATUS_FAILURE	NdisFRestartFilter returns NDIS_STATUS_FAILURE if none of the preceding values applies.

Remarks

The filter driver can change the filter module attributes at run time by calling the NdisFRestartFilter function. NdisFRestartFilter schedules a pause and then a restart operation for the specified filter module.

Before NDIS restarts the filter module, it calls the FilterSetModuleOptions function for the filter module. From its FilterSetModuleOptions function, the filter driver can change the data handlers for that filter module by calling the NdisSetOptionalHandlers function and specifying a new set of handlers.

Requirements

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and later.
Target Platform	Desktop
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	Irql_Filter_Driver_Function(ndis)