PMGM_JOIN_ALERT_CALLBACK Rückruffunktion (mgm.h)

Artikel
02/29/2024

Der PMGM_JOIN_ALERT_CALLBACK Rückrufs ist ein Aufruf eines Routingprotokolls, um das Protokoll zu benachrichtigen, dass neue Empfänger für eine oder mehrere Gruppen auf Schnittstellen vorhanden sind, die anderen Routingprotokollen gehören. Sobald ein Routingprotokoll diesen Rückruf empfängt, sollte es mit der Weiterleitung von Multicastdaten für die angegebene Quelle und Gruppe beginnen.

Syntax

PMGM_JOIN_ALERT_CALLBACK PmgmJoinAlertCallback;

DWORD PmgmJoinAlertCallback(
  [in] DWORD dwSourceAddr,
  [in] DWORD dwSourceMask,
  [in] DWORD dwGroupAddr,
  [in] DWORD dwGroupMask,
  [in] BOOL bMemberUpdate
)
{...}

Parameter

[in] dwSourceAddr

Gibt die Quelladresse an, von der die Multicastdaten empfangen wurden. Null gibt an, dass Daten von allen Quellen empfangen werden (ein Wildcardempfänger für eine Gruppe). Andernfalls ist der Wert von dwSourceAddr die IP-Adresse des Quell- oder Quellnetzwerks.

Um einen Bereich von Quelladressen anzugeben, gibt der Multicastgruppen-Manager das Quellnetzwerk mithilfe von dwSourceAddr an und gibt eine Subnetzmaske mit dwSourceMask an.

[in] dwSourceMask

Gibt die Subnetzmaske an, die dwSourceAddr entspricht. Die Parameter dwSourceAddr und dwSourceMask werden zusammen verwendet, um einen Bereich von Quellen zu definieren, aus dem Multicastdaten empfangen werden.

Der Multicastgruppen-Manager gibt null für diesen Parameter an, wenn er auch null für dwSourceAddr (einen Feldhalterempfänger) angegeben hat.

[in] dwGroupAddr

Gibt die Multicastgruppe an, für die die Daten bestimmt sind. Null gibt an, dass alle Gruppen empfangen werden (ein Wildcardempfänger); andernfalls ist der Wert von dwGroupAddr die IP-Adresse der Gruppe.

Um einen Bereich von Gruppenadressen anzugeben, gibt der Multicastgruppen-Manager die Gruppenadresse mithilfe von dwGroupAddr an und gibt eine Subnetzmaske mit dwGroupMask an.

[in] dwGroupMask

Gibt die Subnetzmaske an, die dwGroupAddr entspricht. Die Parameter dwGroupAddr und dwGroupMask werden zusammen verwendet, um einen Bereich von Multicastgruppen zu definieren.

Der Multicastgruppen-Manager gibt null für diesen Parameter an, wenn er auch null für dwGroupAddr (einen Feldhalterempfänger) angegeben hat.

[in] bMemberUpdate

Gibt an, ob der Rückruf aufgerufen wurde, weil mgmAddGroupMembershipEntry von einem Client aufgerufen wurde (der Multicastgruppen-Manager legt diesen Parameter auf TRUE fest), oder weil ein MFE erstellt oder aktualisiert wurde (der Multicastgruppen-Manager legt diesen Parameter auf FALSE fest).

Rückgabewert

RRAS erwartet nicht, dass die Anwendung einen bestimmten Wert zurückgibt. alle zurückgegebenen Werte werden von RRAS ignoriert.

Hinweise

Der Multicastgruppen-Manager legt den bMemberUpdate-Parameter auf TRUE fest und ruft diesen Rückruf auf, wenn ein Client die MgmAddGroupMembershipEntry-Funktion für einen Eintrag (s, g), (, g) oder (, *) aufruft (d. a. die Gruppenmitgliedschaft hat sich geändert).

Der Multicastgruppen-Manager legt den bMemberUpdate-Parameter auf FALSE fest , wenn sich die Liste der ausgehenden Schnittstellen für eine MFE ändert. Diese Änderung tritt in der Regel bei einer Änderung der Mitgliedschaft für die Gruppe auf, die der MFE entspricht.

Ein Multicastroutingprotokoll kann den bMemberUpdate-Parameter verwenden, um zwischen Änderungen an der Gruppenmitgliedschaft und Änderungen an der MFE zu unterscheiden.

Die Vom Routingprotokoll ausgeführte Aktion, wenn dieser Rückruf empfangen wird, ist protokollspezifisch. Das Protokoll kann den Rückruf ignorieren, wenn der bMemberUpdate-Parameter auf FALSE festgelegt ist, wenn die Protokollspezifikation angibt, dass dies das richtige Verhalten ist.

Wenn MgmAddGroupMembershipEntry aufgerufen wird, verwendet der Multicastgruppen-Manager diesen Rückruf, um andere Multicastgruppen-Manager-Clients zu benachrichtigen, dass empfänger für die angegebene Quelle und Gruppe vorhanden sind.

Der Multicastgruppen-Manager verwendet die folgenden Regeln, um zu bestimmen, wann dieser Rückruf für Wildcard-Joins (*, g) aufgerufen werden soll:

Wenn dies der erste Client ist, der den Multicastgruppen-Manager darüber informiert, dass es Empfänger auf einer Schnittstelle für eine Gruppe gibt, ruft der Multicastgruppen-Manager den PMGM_JOIN_ALERT_CALLBACK Rückruf für alle anderen registrierten Clients auf.
Wenn dies der zweite Client ist, der den Multicastgruppen-Manager darüber informiert, dass es Empfänger auf einer Schnittstelle für eine Gruppe gibt, ruft der Multicastgruppen-Manager diesen Rückruf für den ersten Client auf, um der Gruppe beizutreten.

Der Multicastgruppen-Manager ruft diesen Rückruf nicht für nachfolgende Verknüpfungen mit der Gruppe auf.

Der Multicastgruppen-Manager verwendet die folgende Regel, um zu bestimmen, wann dieser Rückruf für quellspezifische (s, g) Joins aufgerufen werden soll:

Wenn dies der erste Client ist, der den Multicastgruppen-Manager darüber informiert, dass es Empfänger auf einer Schnittstelle für eine Quelle und Gruppe gibt, ruft der Multicastgruppen-Manager den PMGM_JOIN_ALERT_CALLBACK Rückruf nur für den Client auf, der die eingehende Schnittstelle zu den Quell-"s" besitzt.

Diese Version der Multicast-Gruppen-Manager-API unterstützt nur Wildcardquellen (*, g) oder bestimmte Quellen (s, g), nicht einen Bereich von Quellen. Die gleiche Einschränkung gilt für Gruppen (d. a. keine Gruppenbereiche sind zulässig).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mgm.h

Freigeben über