A.2.4.1 Ethernet Filter Library Functions
Table A.2.18 defines the functions included in the Ethernet filter library (efilter.c). In the Network Driver Reference, Chapter 2, Section 2.2 defines several filter library macros. A NIC driver can access these functions and macros by including the efilter.h file.
The driver must contain three action functions the Ethernet filter library functions can call back: MacChangeFilter, MacChangeEthAddresses, and MacCloseAction. For more information about these functions, see Section A.2.1. The NIC driver registers these functions in a call to the Ethernet filter library function EthCreateFilter.
Table A.2.18 Ethernet Filter Library Functions
Function | Definition |
EthChangeFilterAddresses | Changes the multicast address list for a binding filter in the Ethernet filter library database. |
EthCreateFilter | Creates and initializes the Ethernet filter library database associated with one network interface card. |
EthDeleteFilter | Deletes memory associated with the Ethernet filter library database. |
EthDeleteFilterOpenAdapter | Deletes binding filter information for a network interface card from the Ethernet filter library database. |
EthFilterAdjust | Adjusts the Ethernet filter library database. |
EthFilterIndicateReceive | Indicates a received packet to all Ethernet filter library database bindings associated with an Ethernet address. |
EthFilterIndicateReceiveComplete | Indicates to all bound transport drivers that EthFilterIndicateReceive has returned. |
EthNoteFilterOpenAdapter | Adds a binding filter to the Ethernet filter library database. |
EthNumberOfOpenFilterAddresses | Counts the number of Ethernet filter library database multicast addresses in a binding filter. |
EthQueryGlobalFilterAddresses | Queries the Ethernet filter library database for a list of multicast addresses associated with a particular network interface card. |
EthQueryOpenFilterAddresses | Queries the Ethernet filter library database for a list of multicast addresses associated with a binding. |
EthShouldAddressLoopBack | 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. |