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

PMGM_LOCAL_LEAVE_CALLBACK コールバックは、ルーティング プロトコルへの呼び出しであり、IGMP がルーティング プロトコルによって現在所有されているインターフェイス上のグループのレシーバーがなくなったことを IGMP が検出したことをルーティング プロトコルに通知します。

このコールバックは、 MgmDeleteGroupMembershipEntry 関数が IGMP によって呼び出されたときに呼び出されます。

構文

PMGM_LOCAL_LEAVE_CALLBACK PmgmLocalLeaveCallback;

DWORD PmgmLocalLeaveCallback(
  [in] DWORD dwSourceAddr,
  [in] DWORD dwSourceMask,
  [in] DWORD dwGroupAddr,
  [in] DWORD dwGroupMask,
  [in] DWORD dwIfIndex,
  [in] DWORD dwIfNextHopAddr
)
{...}

パラメーター

[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 を指定します。

戻り値

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

注釈

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

要件

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

こちらもご覧ください

PMGM_LOCAL_JOIN_CALLBACK