TrFilterAdjust

NDIS_STATUS
    TrFilterAdjust(
        IN PTR_FILTER Filter,
        IN NDIS_HANDLE NdisFilterHandle,
        IN PNDIS_REQUEST NdisRequest,
        IN UINT FilterClasses,
        IN BOOLEAN Set
        );

TrFilterAdjust is called by a NIC driver to adjust a Token Ring 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 this function passes to a NIC driver action function.

FilterClasses

Specifies a bitmap of filter classes this function adds or 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

If TrFilterAdjust does not call MacChangeFilter, it returns NDIS_STATUS_SUCCESS to indicate that the filter class changes do not affect the combined packet filter mask.

If TrFilterAdjust calls the NIC driver’s MacChangeFilter function, it returns the status code the latter returns.

Comments

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

If MacChangeFilter returns a code other than NDIS_STATUS_PENDING or NDIS_STATUS_SUCCESS, the call to TrFilterAdjust has no effect on the network interface card or its functional address.

Callers of TrFilterAdjust run at IRQL DISPATCH_LEVEL.

See Also

MacChangeFilter