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(
  _In_ NDIS_HANDLE NdisFilterHandle
);

Parameters

NdisFilterHandle [in]

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 codeDescription
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

Target platform

Desktop

Version

Supported in NDIS 6.0 and later.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

Irql_Filter_Driver_Function

See also

FilterAttach
FilterSetModuleOptions
NdisSetOptionalHandlers

 

 

Send comments about this topic to Microsoft

Show: