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. |