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

PMGM_CREATION_ALERT_CALLBACK

コールバック

シグネチャ

DWORD PMGM_CREATION_ALERT_CALLBACK(
    DWORD dwSourceAddr,
    DWORD dwSourceMask,
    DWORD dwGroupAddr,
    DWORD dwGroupMask,
    DWORD dwInIfIndex,
    DWORD dwInIfNextHopAddr,
    DWORD dwIfCount,
    MGM_IF_ENTRY* pmieOutIfList
);

パラメーター

フィールド型説明
dwSourceAddrDWORD

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

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

dwSourceMaskDWORD

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

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

dwGroupAddrDWORD

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

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

dwGroupMaskDWORD

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

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

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

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

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

dwIfCountDWORDpmieOutIfList が指すバッファー内のインターフェイスの数を指定します。
pmieOutIfListMGM_IF_ENTRY*

入力時は、データの転送先となる、プロトコルが所有するインターフェイスのセットを格納したバッファーへのポインターです。

出力時は、クライアントは対応する MGM_IF_ENTRY 構造体の bIsEnabled メンバーを FALSE に設定することで、自身のいずれのインターフェイス上でも転送が行われないようにできます。転送を禁止する必要がないクライアントもあり、そのようなクライアントは bIsEnabled の既定値をそのまま使用します。

公式ドキュメント

PMGM_CREATION_ALERT_CALLBACK コールバックは、ルーティングプロトコルへの呼び出しです。この呼び出しでは、新しいソースからのマルチキャストパケットを転送すべきインターフェイスを、ルーティングプロトコルが所有するインターフェイスの中から決定します。

新しいソースから送信されたパケット、または新しいグループ宛てのパケットがインターフェイスに到着すると、マルチキャストグループマネージャーは新しい MFE を作成します。続いてマルチキャストグループマネージャーは、この新しい MFE に送信インターフェイスを持つルーティングプロトコルに対して、このコールバックを呼び出します。ルーティングプロトコルは、特定のインターフェイス上でソースからグループへのデータ転送を無効にすることを選択できます。

戻り値

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

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