MIB_IPMCAST_MFE (Compact 7)

3/12/2014

This structure stores the information for an IP Multicast Forwarding Entry (MFE).

Syntax

typedef struct _MIB_IPMCAST_MFE {
  DWORD dwGroup;
  DWORD dwSource;
  DWORD dwSrcMask;
  DWORD dwUpStrmNgbr;
  DWORD dwInIfIndex;
  DWORD dwInIfProtocol;
  DWORD dwRouteProtocol;
  DWORD dwRouteNetwork;
  DWORD dwRouteMask;
  ULONG ulUpTime;
  ULONG ulExpiryTime;
  ULONG ulTimeOut;
  ULONG ulNumOutIf;
  DWORD fFlags;
  DWORD dwReserved;
  MIB_IPMCAST_OIF rgmioOutInfo[ANY_SIZE];
} MIB_IPMCAST_MFE,
  *PMIB_IPMCAST_MFE;

Members

• dwGroup
  The range of IPv4 multicast groups for this MFE. A value of zero indicates a wildcard group.

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

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

• dwUpStrmNgbr
  The upstream neighbor that is related to this MFE.

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

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

• dwRouteProtocol
  The client that created the route.

• dwRouteNetwork
  The IPv4 address associated with the route referred to by dwRouteProtocol.

• dwRouteMask
  The IPv4 mask associated with the route referred to by dwRouteProtocol.

• ulUpTime
  The time, in seconds, this MFE has been valid. This value starts from zero and is incremented until it reaches the ulTimeOut value, at which time the MFE is deleted.

• ulExpiryTime
  The time, in seconds, that remains before the MFE expires and is deleted. This value starts from ulTimeOut and is decremented until it reaches zero, at which time the MFE is deleted.

• ulTimeOut
  The total length of time, in seconds, that this MFE should remain valid. After the time-out value is exceeded, the MFE is deleted. This value is static.

• ulNumOutIf
  The number of outgoing interfaces that are associated with this MFE.

• fFlags
  Reserved. This member should be NULL.

• dwReserved
  Reserved. This member should be NULL.

• rgmioOutInfo
  A pointer to a table of outgoing interface statistics that are implemented as an array of MIB_IPMCAST_OIF structures.

Remarks

The MIB_IPMCAST_MFE structure does not have a fixed size. Use the SIZEOF_MIB_MFE(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.

The MIB_IPMCAST_MFE structure is used by the Multicast Group Manager functions. The MIB_IPMCAST_MFE structure is retrieved by using the MgmGetMfe function. An existing MIB_IPMCAST_MFE structure can be modified by using the MgmSetMfe function.

Requirements

See Also

Reference

MIB Structures
MIB_MFE_TABLE
MIB_IPMCAST_OIF