NdisFRestartFilter function

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

Syntax

NDIS_STATUS NdisFRestartFilter(
  NDIS_HANDLE NdisFilterHandle
);

Parameters

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

   
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

See Also

FilterAttach

FilterSetModuleOptions

NdisSetOptionalHandlers