MIB_IPMCAST_MFE (Compact 2013)
3/26/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
Header |
ws2def.h, |