OID_802_3_MULTICAST_LIST (Windows Embedded CE 6.0)

1/6/2010

This object specifies the multicast address list on the NIC enabled for packet reception. For a query, NDIS returns a list containing the union of all bindings' multicast address lists.

When a NIC driver initializes, it resets the NIC so the multicast address list is 0. NDIS also initializes the packet filter so it does not allow the protocol driver to receive multicast packets.

To receive a multicast packet, the protocol driver must later set the packet filter to include the NDIS_PACKET_TYPE_MULTICAST flag. At any time, it can disable multicast packet reception by canceling this flag. The order in which the protocol driver enables reception for multicast packets is not important.

The NIC driver can set a limit on the number of multicast addresses bound protocol drivers can enable simultaneously. NDIS returns NDIS_STATUS_MULTICAST_FULL if a protocol driver exceeds this limit or if it specifies an invalid multicast address.

A protocol driver can set the packet filter to enable all multicast packets, and do the filtering itself.

For a query, NdisRequestQueryInformation returns the list of its specific binding. The 'union' of all bindings' multicast address lists will only be performed if the RequestType in NDIS_REQUEST is NdisRequestQueryStatistics.

Requirements

Header ntddndis.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Ethernet Object Identifiers
MiniportQueryInformation
NDIS_PACKET
NdisRequest
NDIS_REQUEST
OID_GEN_CURRENT_PACKET_FILTER