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 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應