This function is called by the NIC driver to query the Ethernet filter library database for a list of multicast addresses associated with the network interface card.
Header file: | Ndis.h |
Windows CE versions: | 2.0 and later |
VOID EthQueryGlobalFilterAddresses( OUT PNDIS_STATUS Status,
IN PETH_FILTER Filter, IN UINT SizeOfArray,
OUT PUINT NumberOfAddresses,
IN OUT CHAR AddressArray[][ETH_LENGTH_OF_ADDRESS] );
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 a binding has altered the multicast address list. Before calling this function, the NIC driver uses the ETH_NUMBER_OF_GLOBAL_FILTER_ADDRESSES macro 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.