A.2.4.2 Token Ring Filter Library Functions

Token Ring filter library (tfilter.c) functions are defined in Table A.2.19. In the Network Driver Reference, Chapter 2, Section 2.2 defines several filter library macros. The NIC driver can access these functions and macros by including tfilter.h in its code.

The driver must contain four NIC driver action functions for the Token Ring filter library to call back: MacChangeGroup, MacChangeTrAddress, MacChangeFilter, and MacCloseAction. For more information on these functions, see Section A.2.1. The NIC driver registers these functions in a call to the Token Ring filter library function, TrCreateFilter.

Table A.2.19 Token Ring Filter Library Functions

Function	Definition
TrChangeFunctionalAddress	Changes the overall functional address for a network interface card.
TrChangeGroupAddress	Changes the overall network card group address associated with a Token Ring binding filter.
TrCreateFilter	Creates and initializes the Token Ring filter library database associated with a network interface card.
TrDeleteFilter	Deletes memory associated with the Token Ring filter library database.
TrDeleteFilterOpenAdapter	Deletes network card binding filter information from the Token Ring filter library database.
TrFilterAdjust	Adjusts the Token Ring filter library database.
TrFilterIndicateReceive	Indicates a received packet to all Token Ring filter library database bindings associated with a Token Ring address.
TrFilterIndicateReceiveComplete	Indicates to all bound transport drivers that TrFilterIndicateReceive has returned.
TrNoteFilterOpenAdapter	Adds a binding to the Token Ring filter library database.
TrShouldAddressLoopBack	Determines if the NIC driver should place a packet on the network card logical adapter loopback queue to avoid transmitting the packet on the network.