Microsoft Windows CE 3.0  

EthCreateFilter

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 an NIC driver. It creates and initializes an Ethernet filter library database associated with one network interface card (NIC).

BOOLEAN EthCreateFilter(IN UINT
MaximumMulticastAddresses
,
IN ETH_ADDRESS_CHANGE
AddressChangeAction
,
IN ETH_FILTER_CHANGE
FilterChangeAction
,
IN ETH_DEFERRED_CLOSE
CloseAction
,
IN PUCHAR
AdapterAddress
,
IN PNDIS_SPIN_LOCK
Lock
,
OUT PETH_FILTER*
Filter
);

Parameters

MaximumMulticastAddresses
Specifies the maximum number of multicast addresses supported by the filter.
AddressChangeAction
Handle to the caller's MacChangeEthAddressesfunction, which the Ethernet filter library calls when a change occurs in the list of multicast addresses that the network interface card enables.
FilterChangeAction
Handle to the caller's MacChangeFilterfunction, which the Ethernet filter library calls when a binding sets or clears a particular filter class. The binding must be the first or only binding using the filter class.
CloseAction
Specifies the address of the caller's MacCloseActionfunction, which the Ethernet filter library calls if a binding closes while it is indicating incoming data through the NdisMEthIndicateReceivefunction.
AdapterAddress
Pointer to the network address of the NIC.
Lock
Pointer to an initialized spin lock that the driver must hold when it requires exclusive access to the Ethernet filter library database.
Filter
Pointer to a caller-supplied variable in which this function writes a pointer to the created filter.

Return Values

TRUE indicates success.

Remarks

The NIC driver uses the Ethernet filter library to filter received network packets. Using the destination address of a received packet, the filter library determines the protocol driver bindings that receive indications for the packet.

A driver that calls this function runs at IRQL PASSIVE_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

EthDeleteFilter, NdisAllocateSpinLock, NdisMEthIndicateReceive



 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.