NdisFRestartFilter function (ndis.h)
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 |
|---|---|
|
NdisFRestartFilter returns NDIS_STATUS_SUCCESS if it started the restart operation. |
|
NdisFRestartFilter failed because of insufficient resources. |
|
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) |