EthFilterAdjust

This function is called by an NIC driver to adjust an Ethernet filter library database.

At a Glance

Header file:	Ndis.h
Windows CE versions:	2.0 and later

Syntax

NDIS_STATUS EthFilterAdjust( IN PETH_FILTER Filter,
IN NDIS_HANDLE NdisFilterHandle, IN PNDIS_REQUEST NdisRequest,
IN UINT FilterClasses, IN BOOLEAN Set );

Parameters

Filter: Pointer to a previously created and initialized filter library database.
NdisFilterHandle: Handle that the filter library associates with the binding filter.
NdisRequest: Pointer to the request structure that this function passes to an NIC driver action function.
FilterClasses: Specifies a bitmap of filter classes that this function adds and deletes.
Set: Specifies TRUE if changes do not result from the closing of the binding. This function does not use Set but passes it to an NIC driver action function.

Return Values

NDIS_STATUS_SUCCESS indicates success. The following indicate failure:

NDIS_STATUS_PENDING
NDIS_STATUS_RESET_IN_PROGRESS

Remarks

This function calls an NIC driver’s function if no binding has used a particular filter class and at least one binding starts using that class. This function also calls an action function for the reverse situation. If the NIC driver action function returns a status code that indicates neither pending nor success, this function restores the filter library database to its original state.

The NIC driver must be holding the filter library spin lock when it calls this function.

A driver that calls this function runs at IRQL DISPATCH_LEVEL.