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.