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

[アーティクル]
03/05/2024

PMGM_PRUNE_ALERT_CALLBACK コールバックは、他のルーティングプロトコルが所有するインターフェイスに受信側が存在しなくなったことをプロトコルに通知するルーティングプロトコルの呼び出しです。

構文

PMGM_PRUNE_ALERT_CALLBACK PmgmPruneAlertCallback;

DWORD PmgmPruneAlertCallback(
  [in]      DWORD dwSourceAddr,
  [in]      DWORD dwSourceMask,
  [in]      DWORD dwGroupAddr,
  [in]      DWORD dwGroupMask,
  [in]      DWORD dwIfIndex,
  [in]      DWORD dwIfNextHopAddr,
  [in]      BOOL bMemberDelete,
  [in, out] PDWORD pdwTimeout
)
{...}

パラメーター

[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] dwIfIndex

マルチキャストデータの受信を停止するインターフェイスを指定します。

[in] dwIfNextHopAddr

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

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

[in] bMemberDelete

MgmAddGroupMembershipEntry がクライアントによって呼び出されたか (マルチキャストグループマネージャーがこのパラメーターを TRUE に設定)、または MFE が作成または更新された (マルチキャストグループマネージャーがこのパラメーターを FALSE に設定) ためにコールバックが呼び出されたかどうかを指定します。

[in, out] pdwTimeout

入力時に、 pdwTimeout は DWORD サイズのメモリ位置を指します。

bMemberDelete が FALSE の場合、このパラメーターを使用して、対応する MFE をマルチキャスト転送キャッシュに保持する期間を指定できます。クライアントが値を指定しない場合、既定値は 900 秒です。

出力時に、 pdwTimeout はこの MFE のタイムアウト値 (秒単位) を受け取ります。

戻り値

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

注釈

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

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

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

このコールバックを受信したときにルーティングプロトコルによって実行されるアクションは、プロトコル固有です。プロトコルの仕様でこれが正しい動作であることが示されている場合、 bMemberDelete パラメーターが FALSE に設定されている場合、プロトコルはコールバックを無視する可能性があります。

MgmDeleteGroupMembershipEntry が呼び出されると、マルチキャストグループマネージャーはこのコールバックを使用して、指定されたソースとグループのレシーバーがもうないことを他のマルチキャストグループマネージャークライアントに通知します。

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

最後から 2 番目のクライアントの最終インターフェイスが削除される場合 (つまり、1 つのクライアントのみのインターフェイスが残っている場合)、マルチキャストグループマネージャーはその残りのクライアントに 対してPMGM_PRUNE_ALERT_CALLBACK コールバックを呼び出します。
最後のクライアント (つまり、他のインターフェイスが残っていない場合) の最終インターフェイスが削除される場合、このコールバックは、マルチキャストグループマネージャーに登録されている他のすべてのクライアントに対して呼び出されます。

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

グループ (s、g) のソース固有の排除を受信すると、マルチキャストグループマネージャーは、ソース "s" に向けて受信インターフェイスを所有するクライアントに対してのみ PMGM_PRUNE_ALERT_CALLBACK コールバックを呼び出します。

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

要件

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

こちらもご覧ください

PMGM_CREATION_ALERT_CALLBACK

Share via

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

構文

パラメーター

戻り値

注釈

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース