NdisFRestartFilter (Compact 2013)

3/26/2014

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

  • 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:

Value

Meaning

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 previous 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 restart the filter module, NDIS calls the FilterSetModuleOptions function for the filter module. From FilterSetModuleOptions , 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

Header

ndis.h

See Also

Reference

NDIS Functions for Filter Drivers
FilterAttach
FilterSetModuleOptions
NdisSetOptionalHandlers