Win32 API 日本語リファレンス
ホーム › NetworkManagement.Rras › PMGM_LOCAL_JOIN_CALLBACK

PMGM_LOCAL_JOIN_CALLBACK

コールバック

シグネチャ

DWORD PMGM_LOCAL_JOIN_CALLBACK(
    DWORD dwSourceAddr,
    DWORD dwSourceMask,
    DWORD dwGroupAddr,
    DWORD dwGroupMask,
    DWORD dwIfIndex,
    DWORD dwIfNextHopAddr
);

パラメーター

フィールド型説明
dwSourceAddrDWORD

マルチキャストデータの受信元となるソースアドレスを指定します。0 は、すべてのソースからデータを受信すること (グループに対するワイルドカード受信者) を示します。それ以外の場合、dwSourceAddr の値はソースまたはソースネットワークの IP アドレスです。

ソースアドレスの範囲を指定するには、マルチキャストグループマネージャーは dwSourceAddr でソースネットワークを指定し、dwSourceMask でサブネットマスクを指定します。

dwSourceMaskDWORD

dwSourceAddr に対応するサブネットマスクを指定します。dwSourceAddr パラメーターと dwSourceMask パラメーターは、マルチキャストデータを受信するソースの範囲を定義するために組み合わせて使用します。

マルチキャストグループマネージャーは、dwSourceAddr に 0 を指定した場合 (ワイルドカード受信者) は、このパラメーターにも 0 を指定します。

dwGroupAddrDWORD

データの宛先となるマルチキャストグループを指定します。0 は、すべてのグループを受信すること (ワイルドカード受信者) を示します。それ以外の場合、dwGroupAddr の値はグループの IP アドレスです。

グループアドレスの範囲を指定するには、マルチキャストグループマネージャーは dwGroupAddr でグループアドレスを指定し、dwGroupMask でサブネットマスクを指定します。

dwGroupMaskDWORD

dwGroupAddr に対応するサブネットマスクを指定します。dwGroupAddr パラメーターと dwGroupMask パラメーターは、マルチキャストグループの範囲を定義するために組み合わせて使用します。

マルチキャストグループマネージャーは、dwGroupAddr に 0 を指定した場合 (ワイルドカード受信者) は、このパラメーターにも 0 を指定します。

dwIfIndexDWORDソースからのマルチキャストデータが到着するインターフェイスを指定します。
dwIfNextHopAddrDWORD

dwIfIndex で指定されたインデックスに対応するネクストホップのアドレスを指定します。dwIfIndex パラメーターと dwIfNextHopIPAddr パラメーターにより、ポイントツーマルチポイントインターフェイス上のネクストホップが一意に識別されます。ポイントツーマルチポイントインターフェイスとは、1 つのインターフェイスが複数のネットワークに接続する接続形態です。ポイントツーマルチポイントインターフェイスの例としては、非ブロードキャストマルチアクセス (NBMA) インターフェイスや、すべてのダイヤルアップクライアントが接続する内部インターフェイスがあります。

dwIfIndex の値だけで識別されるブロードキャストインターフェイス (イーサネットインターフェイスなど) やポイントツーポイントインターフェイスの場合は、0 を指定します。

公式ドキュメント

PMGM_LOCAL_JOIN_CALLBACK コールバックは、ルーティングプロトコルが現在所有しているインターフェイス上で、あるグループに対する新しい受信者を IGMP が検出したことを、ルーティングプロトコルに通知するための呼び出しです。

このコールバックは、IGMP が MgmAddGroupMembershipEntry 関数を呼び出したときに呼び出されます。

戻り値

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

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)