Partager via

2.2.1.2.177 IGMP_MIB_IF_STATS

  • Article

The IGMP_MIB_IF_STATS structure contains statistics about an interface.

 typedef struct _IGMP_MIB_IF_STATS {
   DWORD IfIndex;
   DWORD IpAddr;
   DWORD IfType;
   BYTE State;
   BYTE QuerierState;
   DWORD IgmpProtocolType;
   DWORD QuerierIpAddr;
   DWORD ProxyIfIndex;
   DWORD QuerierPresentTimeLeft;
   DWORD LastQuerierChangeTime;
   DWORD V1QuerierPresentTimeLeft;
   DWORD Uptime;
   DWORD TotalIgmpPacketsReceived;
   DWORD TotalIgmpPacketsForRouter;
   DWORD GeneralQueriesReceived;
   DWORD WrongVersionQueries;
   DWORD JoinsReceived;
   DWORD LeavesReceived;
   DWORD CurrentGroupMemberships;
   DWORD GroupMembershipsAdded;
   DWORD WrongChecksumPackets;
   DWORD ShortPacketsReceived;
   DWORD LongPacketsReceived;
   DWORD PacketsWithoutRtrAlert;
 } IGMP_MIB_IF_STATS,
  *PIGMP_MIB_IF_STATS;

IfIndex: The index of the interface.

IpAddr: The IP address of the interface. If the interface is a RAS interface, then the IpAddr is set to the NextHopAddress of the RAS client.

IfType: The type of the interface. It MUST be one of the following values.

Value

Meaning

IGMP_IF_NOT_RAS

0x00000001

The interface is connected to a LAN.

IGMP_IF_RAS_ROUTER

0x00000002

The interface is connected to another router over RAS.

IGMP_IF_RAS_SERVER

0x00000003

The entry corresponds to a RAS server if it contains statistics and it represents summary statistics.

IGMP_IF_RAS_CLIENT

0x00000004

The entry corresponds to a RAS client.

IGMP_IF_PROXY

0x00000008

The interface is an IGMP PROXY. One of the first four flags will still be set to enable the switch from the proxy to the IGMP router.

State: It MUST be a combination of one or more of the following values.

Value

Meaning

IGMP_STATE_BOUND

0x01

The socket is bound.

IGMP_STATE_ENABLED_BY_RTRMGR

0x02

The interface is enabled by router.

IGMP_STATE_ENABLED_IN_CONFIG

0x04

The interface is enabled in the configuration.

IGMP_STATE_ENABLED_BY_MGM

0x08

The interface is enabled by component that aggregates multiple routing protocols.

QuerierState: It MUST be one of the following.

Value

Meaning

RTR_QUERIER

0x10

The interface is the IGMP querier.

RTR_NOT_QUERIER

0x00

The interface is not the IGMP querier.

IgmpProtocolType: Takes one of the following values.

Value

Meaning

IGMP_PROXY

0x00000000

The interface is an IGMPv2 proxy.

Specifies that the IGMPv2 proxy mode is enabled on this interface. An interface in IGMP proxy mode acts as a host, forwarding the IGMP host membership messages for all the IGMP host membership messages received on all other interfaces on which the IGMP router mode is enabled. Additionally, all nonlocal multicast traffic received on all other interfaces (on which the IGMP router mode is enabled) is forwarded over the IGMP proxy mode interface.

IGMP_ROUTER_V1

0x00000001

The interface is an IGMPv1 router.

Specifies that IGMPv1 router mode is enabled on this interface. An interface in IGMP router mode listens for IGMP messages from hosts and updates the TCP/IP multicast forwarding table.

IGMP_ROUTER_V2

0x00000002

The interface is an IGMPv2 router.

Specifies that IGMPv2 router mode is enabled on this interface. An interface in IGMP router mode listens for IGMP messages from hosts and updates the TCP/IP multicast forwarding table.

IGMP_ROUTER_V3

0x00000003

The interface is an IGMPv3 router.

Specifies that IGMPv3 router mode is enabled on this interface. An interface in IGMP router mode listens for IGMP messages from hosts and updates the TCP/IP multicast forwarding table.

IGMP_PROXY_V3

0x00000010

The interface is an IGMPv3 proxy.

Specifies that IGMPv3 proxy mode is enabled on this interface. An interface in IGMP proxy mode acts as a host, forwarding IGMP host membership messages for all IGMP host membership messages received on all other interfaces on which IGMP router mode is enabled. Additionally, all nonlocal multicast traffic received on all other interfaces (on which IGMP router mode is enabled) is forwarded over the IGMP proxy mode interface.

QuerierIpAddr: The IP address of the querier.

ProxyIfIndex: The IfIndex of the IGMP proxy.

QuerierPresentTimeLeft: If no IGMPv2 queries are heard on this interface within this interval, the local router will take over the querier on the IP subnet to which this interface is attached.

LastQuerierChangeTime: The number of seconds since QuerierIpAddr was last changed.

V1QuerierPresentTimeLeft: The time remaining until the host assumes that there are no IGMPv1 routers present on the interface. While this is nonzero, the host will reply to all queries with version 1 membership reports.

Uptime: The time, in seconds, the interface has been activated.

TotalIgmpPacketsReceived: The total IGMP packets received.

TotalIgmpPacketsForRouter: The total IGMP packets received for a router.

GeneralQueriesReceived: The total queries received.

WrongVersionQueries: The count of wrong version queries received.

JoinsReceived: The count of IGMP joins received.

LeavesReceived: The count of IGMP leaved received.

CurrentGroupMemberships: The count of current group memberships.

GroupMembershipsAdded: The count of group memberships received.

WrongChecksumPackets: The count of packets with wrong checksum received.

ShortPacketsReceived: The count of short packets received.

LongPacketsReceived: The count of long packets received.

PacketsWithoutRtrAlert: The count of packets with router alerts received.