EthQueryOpenFilterAddresses

This function is called by the NIC driver to query the Ethernet filter library database for a list of multicast addresses associated with a binding.

At a Glance

Header file:	Ndis.h
Windows CE versions:	2.0 and later

Syntax

VOID EthQueryOpenFilterAddresses( OUT PNDIS_STATUS Status,
IN PETH_FILTER Filter, IN NDIS_HANDLE NdisFilterHandle,
IN UINT SizeOfArray, OUT PUINT NumberOfAddresses,
OUT CHAR AddressArray[][ETH_LENGTH_OF_ADDRESS] );

Parameters

Status

Pointer to a caller-supplied variable in which this function returns the status of the query operation. Possible values are the following:

NDIS_STATUS_FAILURE
NDIS_STATUS_SUCCESS

Filter

Pointer to a previously created and initialized filter library database.

NdisFilterHandle

Handle that the filter library associates with the binding filter.

SizeOfArray

Specifies the byte count for the 2-D array to contain the addresses.

NumberOfAddresses

Pointer to the caller-supplied variable in which this function returns the number of addresses that it writes to the array.

AddressArray[][ETH_LENGTH_OF_ADDRESS]

Specifies the2-D caller-supplied array to which this function writes addresses currently associated with the binding.

Remarks

The NIC driver calls this function before it alters registers on the network interface card to effect filtering. The timing of the call is important if another binding has altered the multicast address list. Before calling this function, the NIC driver calls the EthNumberOfOpenFilterAddresses function to obtain the number of multicast addresses to be retrieved.

A caller must be holding the database spin lock to call this function, so the driver is running at IRQL DISPATCH_LEVEL.