FddiFilterAdjust

NDIS_STATUS
    FddiFilterAdjust(
        IN PFDDI_FILTER  Filter,
        IN NDIS_HANDLE  NdisFilterHandle,
        IN PNDIS_REQUEST  NdisRequest,
        IN UINT  FilterClasses,
        IN BOOLEAN  Set
        );

FddiFilterAdjust is called by a NIC driver to adjust an FDDI filter library database.

Parameters

Filter

Points to a previously created and initialized filter library database.

NdisFilterHandle

Specifies the handle that the filter library associates with the binding filter.

NdisRequest

Points to the request structure that this function passes to a 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 a NIC driver action function.

Return Value

FddiFilterAdjust can return the following status codes:

NDIS_STATUS_PENDING
NDIS_STATUS_RESET_IN_PROGRESS
NDIS_STATUS_SUCCESS

Comments

This function calls a NIC driver action function if no binding has used a particular filter class and at least one binding starts using that class. The 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, FddiFilterAdjust restores the filter library database to its original state.

A caller must be holding the database spin lock to call FddiFilterAdjust, so the driver is running at IRQL DISPATCH_LEVEL.