PMGM_JOIN_ALERT_CALLBACK

DWORD PMGM_JOIN_ALERT_CALLBACK(
    DWORD dwSourceAddr,
    DWORD dwSourceMask,
    DWORD dwGroupAddr,
    DWORD dwGroupMask,
    BOOL bMemberUpdate
);

PMGM_JOIN_ALERT_CALLBACK コールバックは、他のルーティングプロトコルが所有するインターフェイス上で 1 つ以上のグループに対する新しい受信者が存在することを、ルーティングプロトコルに通知するための呼び出しです。ルーティングプロトコルは、このコールバックを受け取った時点で、指定されたソースおよびグループのマルチキャストデータの転送を開始する必要があります。

RRAS は、アプリケーションが特定の値を返すことを想定していません。返された値は RRAS によって無視されます。

クライアントが (s, g)、(, g)、または (, *) のエントリに対して MgmAddGroupMembershipEntry 関数を呼び出した場合 (つまりグループメンバーシップが変更された場合)、マルチキャストグループマネージャーは bMemberUpdate パラメーターを TRUE に設定し、このコールバックを呼び出します。

MFE の送信インターフェイスリストが変更された場合、マルチキャストグループマネージャーは bMemberUpdate パラメーターを FALSE に設定します。この変更は通常、その MFE に対応するグループのメンバーシップが変化したときに発生します。

マルチキャストルーティングプロトコルは、bMemberUpdate パラメーターを使用して、グループメンバーシップの変更と MFE の変更を区別できます。

このコールバックを受け取ったときにルーティングプロトコルが行う処理は、プロトコル固有です。プロトコルの仕様上それが正しい動作であるならば、プロトコルは bMemberUpdate パラメーターが FALSE に設定されている場合にこのコールバックを無視してもかまいません。

MgmAddGroupMembershipEntry が呼び出されると、マルチキャストグループマネージャーはこのコールバックを使用して、指定されたソースおよびグループに対する受信者が存在することを他のマルチキャストグループマネージャークライアントに通知します。

マルチキャストグループマネージャーは、ワイルドカード (*, g) の参加に対してこのコールバックを呼び出すタイミングを、次の規則に従って決定します。

• あるグループについてインターフェイス上に受信者が存在することをマルチキャストグループマネージャーに通知した最初のクライアントである場合、マルチキャストグループマネージャーは登録された他のすべてのクライアントに対して PMGM_JOIN_ALERT_CALLBACK コールバックを呼び出します。
• あるグループについてインターフェイス上に受信者が存在することをマルチキャストグループマネージャーに通知した 2 番目のクライアントである場合、マルチキャストグループマネージャーは、そのグループに最初に参加したクライアントに対してこのコールバックを呼び出します。

マルチキャストグループマネージャーは、そのグループへのそれ以降の参加に対しては、このコールバックを呼び出しません。

マルチキャストグループマネージャーは、ソース固有 (s, g) の参加に対してこのコールバックを呼び出すタイミングを、次の規則に従って決定します。

• あるソースおよびグループについてインターフェイス上に受信者が存在することをマルチキャストグループマネージャーに通知した最初のクライアントである場合、マルチキャストグループマネージャーは、ソース "s" に向かう受信インターフェイスを所有するクライアントに対してのみ PMGM_JOIN_ALERT_CALLBACK コールバックを呼び出します。

このバージョンの Multicast Group Manager API は、ワイルドカードソース (*, g) または特定のソース (s, g) のみをサポートし、ソースの範囲はサポートしません。同じ制限がグループにも適用されます (つまり、グループの範囲は指定できません)。