PMGM_LOCAL_JOIN_CALLBACK回调函数 (mgm.h)

PMGM_LOCAL_JOIN_CALLBACK回调是调用路由协议，以通知协议 IGMP 已在路由协议当前拥有的接口上检测到组的新接收器。

当 IGMP 调用 MgmAddGroupMembershipEntry 函数时，将调用此回调。

语法

PMGM_LOCAL_JOIN_CALLBACK PmgmLocalJoinCallback;

DWORD PmgmLocalJoinCallback(
  [in] DWORD dwSourceAddr,
  [in] DWORD dwSourceMask,
  [in] DWORD dwGroupAddr,
  [in] DWORD dwGroupMask,
  [in] DWORD dwIfIndex,
  [in] DWORD dwIfNextHopAddr
)
{...}

参数

[in] dwSourceAddr

指定从中接收多播数据的源地址。 零表示从组) 的所有源 (通配符接收器接收数据;否则， dwSourceAddr 的值是源或源网络的 IP 地址。

若要指定源地址的范围，多播组管理器使用 dwSourceAddr 指定源网络，并使用 dwSourceMask 指定子网掩码。

[in] dwSourceMask

指定与 dwSourceAddr 对应的子网掩码。 dwSourceAddr 和 dwSourceMask 参数一起使用，用于定义从中接收多播数据的源范围。

如果多播组管理器也为 dwSourceAddr 指定了零， (通配符接收器) ，则多播组管理器为此参数指定零。

[in] dwGroupAddr

指定数据目标为的多播组。 零表示 (通配符接收器) 接收所有组;否则， dwGroupAddr 的值是组的 IP 地址。

若要指定组地址范围，多播组管理器使用 dwGroupAddr 指定组地址，并使用 dwGroupMask 指定子网掩码。

[in] dwGroupMask

指定与 dwGroupAddr 对应的子网掩码。 dwGroupAddr 和 dwGroupMask 参数一起使用来定义一系列多播组。

如果多播组管理器也为 dwGroupAddr 指定了零， (通配符接收器) ，则多播组管理器为此参数指定零。

[in] dwIfIndex

指定来自源的多播数据应到达的接口。

[in] dwIfNextHopAddr

指定与 dwIfIndex 指定的索引相对应的下一跃点的地址。 dwIfIndex 和 dwIfNextHopIPAddr 参数唯一标识点到多点接口上的下一跃点。 点到多点接口是一个接口连接到多个网络的连接。 点到多点接口的示例包括非广播多路访问 (NBMA) 接口以及所有拨号客户端连接的内部接口。

对于仅由 dwIfIndex 的值标识的广播接口 (例如以太网接口) 或点到点接口，请指定零。

返回值

RRAS 不希望应用程序返回任何特定值;RRAS 将忽略返回的任何值。

注解

此版本的多播组管理器 API 仅支持通配符源 (*、g) 或特定源 (s、g) ，不支持一系列源。 相同的限制适用于组 (即，不允许) 组范围。

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	mgm.h

另请参阅

PMGM_LOCAL_LEAVE_CALLBACK