PMGM_CREATION_ALERT_CALLBACK コールバック関数 (mgm.h)

PMGM_CREATION_ALERT_CALLBACK コールバックは、ルーティング プロトコルへの呼び出しです。 この呼び出しは、新しいソースからのマルチキャスト パケットを転送するルーティング プロトコルによって所有されるインターフェイスのサブセットを決定します。

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

構文

PMGM_CREATION_ALERT_CALLBACK PmgmCreationAlertCallback;

DWORD PmgmCreationAlertCallback(
  [in]      DWORD dwSourceAddr,
  [in]      DWORD dwSourceMask,
  [in]      DWORD dwGroupAddr,
  [in]      DWORD dwGroupMask,
  [in]      DWORD dwInIfIndex,
  [in]      DWORD dwInIfNextHopAddr,
  [in]      DWORD dwIfCount,
  [in, out] PMGM_IF_ENTRY pmieOutIfList
)
{...}

パラメーター

[in] dwSourceAddr

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

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

[in] dwSourceMask

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

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

[in] dwGroupAddr

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

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

[in] dwGroupMask

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

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

[in] dwInIfIndex

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

[in] dwInIfNextHopAddr

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

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

[in] dwIfCount

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

[in, out] pmieOutIfList

入力時に、データが転送されるプロトコルによって所有されるインターフェイスのセットを含むバッファーへのポインター。

出力時に、クライアントは対応するMGM_IF_ENTRY構造体の bIsEnabled メンバーを FALSE に設定して、インターフェイスの転送を防ぐことができます。 転送を防ぐためにクライアントが必要ない場合があります。このようなクライアントは、 既定値の bIsEnabled を受け入れます。

戻り値

RRAS は、アプリケーションが特定の値を返す必要はありません。返された値は RRAS によって無視されます。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mgm.h

こちらもご覧ください

MGM_IF_ENTRY