MIB_IPMCAST_MFE_STATS structure (ipmib.h)

The MIB_IPMCAST_MFE_STATS structure stores the statistics associated with a Multicast Forwarding Entry (MFE).

Syntax

typedef struct _MIB_IPMCAST_MFE_STATS {
  DWORD                 dwGroup;
  DWORD                 dwSource;
  DWORD                 dwSrcMask;
  DWORD                 dwUpStrmNgbr;
  DWORD                 dwInIfIndex;
  DWORD                 dwInIfProtocol;
  DWORD                 dwRouteProtocol;
  DWORD                 dwRouteNetwork;
  DWORD                 dwRouteMask;
  ULONG                 ulUpTime;
  ULONG                 ulExpiryTime;
  ULONG                 ulNumOutIf;
  ULONG                 ulInPkts;
  ULONG                 ulInOctets;
  ULONG                 ulPktsDifferentIf;
  ULONG                 ulQueueOverflow;
  MIB_IPMCAST_OIF_STATS rgmiosOutStats[ANY_SIZE];
} MIB_IPMCAST_MFE_STATS, *PMIB_IPMCAST_MFE_STATS;

Members

dwGroup

Type: DWORD

The multicast group for this MFE. A value of zero indicates a wildcard group.

dwSource

Type: DWORD

The range of source addresses for this MFE. A value of zero indicates a wildcard source.

dwSrcMask

Type: DWORD

The IPv4 subnet mask that corresponds to dwSourceAddr. The dwSourceAddr and dwSourceMask members are used together to define a range of sources.

dwUpStrmNgbr

Type: DWORD

The upstream neighbor that is related to this MFE.

dwInIfIndex

Type: DWORD

The index of the incoming interface to which this MFE is related.

dwInIfProtocol

Type: DWORD

The routing protocol that owns the incoming interface to which this MFE is related.

dwRouteProtocol

Type: DWORD

The client that created the route.

dwRouteNetwork

Type: DWORD

The address associated with the route referred to by dwRouteProtocol.

dwRouteMask

Type: DWORD

The mask associated with the route referred to by dwRouteProtocol.

ulUpTime

Type: ULONG

The time, in 100ths of a seconds, since the MFE was created.

ulExpiryTime

Type: ULONG

The time, in 100ths of a seconds, until the MFE will be deleted. A value of zero is specified if the MFE is not subject to aging requirements.

ulNumOutIf

Type: ULONG

The number of interfaces in the outgoing interface list for this MFE.

ulInPkts

Type: ULONG

The number of packets that have been forwarded that matched this MFE.

ulInOctets

Type: ULONG

The number of octets of data forwarded that match this MFE.

ulPktsDifferentIf

Type: ULONG

The number of packets matching this MFE that were dropped due to an incoming interface check.

ulQueueOverflow

Type: ULONG

The number of packets matching this MFE that were dropped due to a queue overflow. There is one queue per MFE.

rgmiosOutStats[ANY_SIZE]

Type: MIB_IPMCAST_OIF_STATS[ANY_SIZE]

A pointer to a table of outgoing interface statistics that are implemented as an array of MIB_IPMCAST_OIF_STATS structures. The number of entries in the table is specified by the value of the ulNumOutIf member.

Remarks

The MIB_IPMCAST_MFE_STATS structure does not have a fixed size. Use the SIZEOF_MIB_MFE_STATS(X) macro to determine the size of this structure. This macro is defined in the Iprtrmib.h header file.

The dwRouteProtocol, dwRouteNetwork, and dwRouteMask members uniquely identify the route to which this MFE is related.

On the Microsoft Windows Software Development Kit (SDK) released for Windows Vista and later, the organization of header files has changed. This structure is defined in the Ipmib.h header file, not in the Iprtrmib.h header file. Note that the Ipmib.h header file is automatically included in Iprtrmib.h, which is automatically included in the Iphlpapi.h header file. The Ipmib.h and Iprtrmib.h header files should never be used directly.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	ipmib.h (include Iphlpapi.h)

See also

MIB_IPMCAST_OIF_STATS