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