EthQueryOpenFilterAddresses

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

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 two-dimensional 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 the two-dimensional caller-supplied array to which this function writes addresses currently associated with the binding.

Remarks

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

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Ndis.h   Ndislib.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

EthNumberOfOpenFilterAddresses

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.