OID_802_3_MULTICAST_LIST (Compact 2013)

3/26/2014

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

When a network adapter driver initializes, it resets the network adapter so that the multicast address list is 0. NDIS also initializes the packet filter so that 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 network adapter driver can set a limit on the number of multicast addresses bound protocol drivers can enable concurrently. 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

See Also

Reference

Ethernet Operational Characteristics
MiniportQueryInformation
NDIS_PACKET
NdisRequest
NDIS_REQUEST
OID_GEN_CURRENT_PACKET_FILTER
Ethernet Objects