 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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.
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 NIC driver calls this function before it alters registers on the NIC 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 EthNumberOfOpenFilterAddressesfunction 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.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 2.0 and later Ndis.h 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