PMGM_CREATION_ALERT_CALLBACK Rückruffunktion (mgm.h)

Der PMGM_CREATION_ALERT_CALLBACK Rückrufs ist ein Aufruf in ein Routingprotokoll. Dieser Aufruf bestimmt die Teilmenge der Schnittstellen im Besitz des Routingprotokolls, auf der ein Multicastpaket aus einer neuen Quelle weitergeleitet werden soll.

Wenn ein Paket, das von einer neuen Quelle gesendet oder für eine neue Gruppe bestimmt ist, auf einer Schnittstelle eingeht, erstellt der Multicastgruppen-Manager eine neue MFE. Der Multicastgruppen-Manager ruft dann diesen Rückruf für die Routingprotokolle auf, die in dieser neuen MFE über ausgehende Schnittstellen verfügen. Ein Routingprotokoll kann die Weiterleitung von Daten aus der Quelle an die Gruppe auf bestimmten Schnittstellen deaktivieren.

Syntax

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
)
{...}

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 und 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 denen Multicastdaten empfangen werden sollen.

Der Multicastgruppen-Manager gibt null für diesen Parameter an, wenn er auch null für dwSourceAddr (einen Wildcardempfä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 und mithilfe von dwGroupMask eine Subnetzmaske 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 Wildcardempfänger) angegeben hat.

[in] dwInIfIndex

Gibt die Schnittstelle an, auf der die Multicastdaten aus der Quelle eingehen sollen.

[in] dwInIfNextHopAddr

Gibt die Adresse des nächsten Hops an, die dem von dwIfIndex angegebenen Index entspricht. Die Parameter dwIfIndex und dwIfNextHopIPAddr identifizieren einen nächsten Hop auf Point-to-Multipoint-Schnittstellen eindeutig. Eine Point-to-Multipoint-Schnittstelle ist eine Verbindung, bei der eine Schnittstelle eine Verbindung mit mehreren Netzwerken herstellt. Beispiele für Point-to-Multipoint-Schnittstellen sind NBMA-Schnittstellen (Non-Broadcast Multiple Access) und die interne Schnittstelle, über die alle DFÜ-Clients eine Verbindung herstellen.

Geben Sie für Broadcastschnittstellen (z. B. Ethernet-Schnittstellen) oder Punkt-zu-Punkt-Schnittstellen, die nur durch den Wert von dwIfIndex identifiziert werden, null an.

[in] dwIfCount

Gibt die Anzahl der Schnittstellen im Puffer an, auf den pmieOutIfList verweist.

[in, out] pmieOutIfList

Bei der Eingabe ein Zeiger auf einen Puffer, der den Satz von Schnittstellen enthält, der dem Protokoll gehört, auf dem Daten weitergeleitet werden.

In der Ausgabe kann der Client den bIsEnabled-Member der entsprechenden MGM_IF_ENTRY-Struktur auf FALSE festlegen, um eine Weiterleitung auf einer seiner Schnittstellen zu verhindern. Ein Client ist möglicherweise nicht verpflichtet, die Weiterleitung zu verhindern. Ein solcher Client akzeptiert den Standardwert bIsEnabled.

Rückgabewert

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

Anforderungen

Weitere Informationen

MGM_IF_ENTRY