A.2.4.3 FDDI Filter Library Functions

Table A.2.20 defines FDDI filter library (ffilter.c) functions. 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 ffilter.h in its code.

The driver must contain three NIC driver action functions that FDDI filter library functions call back: MacChangeFddiAddresses, MacChangeFilter, and MacCloseAction. For more information about these functions, see Section A.2.1. The NIC driver registers these functions in a call to the FDDI filter library function, FddiCreateFilter.

Table A.2.20 FDDI Filter Library Functions

Function

Definition

FddiChangeFilterShortAddresses

Changes the multicast short address list for a binding filter in the FDDI filter library database.

FddiCreateFilter

Creates and initializes the FDDI filter library database associated with a network interface card.

FddiChangeFilterLongAddresses

Changes the multicast long address list for a binding filter in the FDDI filter library database.

FddiDeleteFilter

Deletes memory associated with the FDDI filter library database.

FddiDeleteFilterOpenAdapter

Deletes network card binding filter information from the FDDI filter library database.

FddiFilterAdjust

Adjusts the FDDI filter library database.

FddiFilterIndicateReceive

Indicates a received packet to all FDDI filter library database bindings associated with an FDDI address.

FddiFilterIndicateReceiveComplete

Indicates to all bound transport drivers that FddiFilterIndicateReceive has returned.

FddiNoteFilterOpenAdapter

Adds a binding filter to the FDDI filter library database.

FddiNumberOfOpenFilterLongAddresses

Counts the number of FDDI filter library database multicast long addresses in a binding filter.

FddiNumberOfOpenFilterShortAddresses

Counts the number of FDDI filter library database multicast short addresses in a binding filter.

FddiQueryGlobalFilterLongAddresses

Queries the FDDI filter library database for a list of multicast long addresses associated with a network interface card.

FddiQueryGlobalFilterShortAddresses

Queries the FDDI filter library database for a list of multicast short addresses associated with a network interface card.

FddiQueryOpenFilterLongAddresses

Queries the FDDI filter library database for a list of multicast long addresses associated with a binding.

FddiQueryOpenFilterShortAddresses

Queries the FDDI filter library database for a list of multicast short addresses associated with a binding.

FddiShouldAddressLoopBack

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.

Function	Definition
FddiChangeFilterShortAddresses	Changes the multicast short address list for a binding filter in the FDDI filter library database.
FddiCreateFilter	Creates and initializes the FDDI filter library database associated with a network interface card.
FddiChangeFilterLongAddresses	Changes the multicast long address list for a binding filter in the FDDI filter library database.
FddiDeleteFilter	Deletes memory associated with the FDDI filter library database.
FddiDeleteFilterOpenAdapter	Deletes network card binding filter information from the FDDI filter library database.
FddiFilterAdjust	Adjusts the FDDI filter library database.
FddiFilterIndicateReceive	Indicates a received packet to all FDDI filter library database bindings associated with an FDDI address.
FddiFilterIndicateReceiveComplete	Indicates to all bound transport drivers that FddiFilterIndicateReceive has returned.
FddiNoteFilterOpenAdapter	Adds a binding filter to the FDDI filter library database.
FddiNumberOfOpenFilterLongAddresses	Counts the number of FDDI filter library database multicast long addresses in a binding filter.
FddiNumberOfOpenFilterShortAddresses	Counts the number of FDDI filter library database multicast short addresses in a binding filter.
FddiQueryGlobalFilterLongAddresses	Queries the FDDI filter library database for a list of multicast long addresses associated with a network interface card.
FddiQueryGlobalFilterShortAddresses	Queries the FDDI filter library database for a list of multicast short addresses associated with a network interface card.
FddiQueryOpenFilterLongAddresses	Queries the FDDI filter library database for a list of multicast long addresses associated with a binding.
FddiQueryOpenFilterShortAddresses	Queries the FDDI filter library database for a list of multicast short addresses associated with a binding.
FddiShouldAddressLoopBack	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.