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.