PMGM_ENABLE_IGMP_CALLBACK callback function (mgm.h)
The PMGM_ENABLE_IGMP_CALLBACK callback is a call into IGMP to notify it that a routing protocol has finished taking or releasing ownership of an interface.
When this callback is invoked, IGMP should add all its group memberships on the specified interface using calls to the MgmAddGroupMembershipEntry function.
Syntax
PMGM_ENABLE_IGMP_CALLBACK PmgmEnableIgmpCallback;
DWORD PmgmEnableIgmpCallback(
[in] DWORD dwIfIndex,
[in] DWORD dwIfNextHopAddr
)
{...}
Parameters
[in] dwIfIndex
Specifies the index of the interface on which to enable IGMP.
[in] dwIfNextHopAddr
Specifies the address of the next hop that corresponds to the index specified by dwIfIndex. The dwIfIndex and dwIfNextHopIPAddr parameters uniquely identify a next hop on point-to-multipoint interfaces. A point-to-multipoint interface is a connection where one interface connects to multiple networks. Examples of point-to-multipoint interfaces include non-broadcast multiple access (NBMA) interfaces and the internal interface on which all dial-up clients connect.
For broadcast interfaces (such as Ethernet interfaces) or point-to-point interfaces, which are identified by only the value of dwIfIndex, specify zero.
Return value
RRAS does not expect the application to return any specific value; any value returned is ignored by RRAS.
Remarks
IGMP must not add group memberships in the context of this callback. The multicast group manager and IGMP become deadlocked.
Requirements
Requirement | Value |
---|---|
Minimum supported client | None supported |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | mgm.h |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for