PMGM_JOIN_ALERT_CALLBACK funzione di callback (mgm.h)

Articolo
03/13/2024

Il callback PMGM_JOIN_ALERT_CALLBACK è una chiamata a un protocollo di routing per notificare al protocollo che i nuovi ricevitori sono presenti per uno o più gruppi su interfacce di proprietà di altri protocolli di routing. Dopo che un protocollo di routing riceve questo callback, deve iniziare a inoltrare i dati multicast per l'origine e il gruppo specificati.

Sintassi

PMGM_JOIN_ALERT_CALLBACK PmgmJoinAlertCallback;

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

Parametri

[in] dwSourceAddr

Specifica l'indirizzo di origine da cui sono stati ricevuti i dati multicast. Zero indica che i dati vengono ricevuti da tutte le origini (un ricevitore jolly per un gruppo); in caso contrario, il valore di dwSourceAddr è l'indirizzo IP della rete di origine o di origine.

Per specificare un intervallo di indirizzi di origine, gestione gruppi multicast specifica la rete di origine usando dwSourceAddr e specifica una subnet mask usando dwSourceMask.

[in] dwSourceMask

Specifica la subnet mask corrispondente a dwSourceAddr. I parametri dwSourceAddr e dwSourceMask vengono usati insieme per definire un intervallo di origini da cui ricevere dati multicast.

Gestione gruppi multicast specifica zero per questo parametro se è stato specificato anche zero per dwSourceAddr (ricevitore con caratteri jolly).

[in] dwGroupAddr

Specifica il gruppo multicast per il quale vengono destinati i dati. Zero indica che tutti i gruppi vengono ricevuti (ricevitore con caratteri jolly); in caso contrario, il valore di dwGroupAddr è l'indirizzo IP del gruppo.

Per specificare un intervallo di indirizzi di gruppo, gestione gruppi multicast specifica l'indirizzo del gruppo usando dwGroupAddr e specifica una subnet mask usando dwGroupMask.

[in] dwGroupMask

Specifica la subnet mask corrispondente a dwGroupAddr. I parametri dwGroupAddr e dwGroupMask vengono usati insieme per definire un intervallo di gruppi multicast.

Gestione gruppi multicast specifica zero per questo parametro se è stato specificato anche zero per dwGroupAddr (ricevitore con caratteri jolly).

[in] bMemberUpdate

Specifica se il callback è stato richiamato perché mgmAddGroupMembershipEntry è stato chiamato da un client (il gestore di gruppi multicast imposta questo parametro su TRUE) o perché un oggetto MFE è stato creato o aggiornato (il gestore gruppi multicast imposta questo parametro su FALSE).

Valore restituito

RRAS non prevede che l'applicazione restituisca alcun valore specifico; qualsiasi valore restituito viene ignorato da RRAS.

Commenti

Il gestore gruppi multicast imposta il parametro bMemberUpdate su TRUE e richiama questo callback se un client chiama la funzione MgmAddGroupMembershipEntry per una voce (s, g), (, g) o (, *) (ovvero, l'appartenenza al gruppo è stata modificata).

Il gestore del gruppo multicast imposta il parametro bMemberUpdate su FALSE se l'elenco di interfacce in uscita per un MFE cambia. Questa modifica si verifica in genere per una modifica dell'appartenenza al gruppo corrispondente a MFE.

Un protocollo di routing multicast può usare il parametro bMemberUpdate per distinguere le modifiche apportate all'appartenenza al gruppo e le modifiche apportate a MFE.

L'azione eseguita dal protocollo di routing quando questo callback viene ricevuto è specifico del protocollo. Il protocollo può ignorare il callback se il parametro bMemberUpdate è impostato su FALSE, se la specifica del protocollo indica che si tratta del comportamento corretto.

Quando MgmAddGroupMembershipEntry viene chiamato, il gestore del gruppo multicast usa questo callback per notificare ad altri client di gestione gruppi multicast che sono presenti ricevitori per l'origine e il gruppo specificati.

Il gestore gruppi multicast usa le regole seguenti per determinare quando richiamare questo callback per i join jolly (*, g):

Se si tratta del primo client per informare il gestore gruppi multicast che sono presenti ricevitori in un'interfaccia per un gruppo, il gestore gruppi multicast richiama il callback PMGM_JOIN_ALERT_CALLBACK a tutti gli altri client registrati.
Se si tratta del secondo client per informare il gestore gruppi multicast che sono presenti ricevitori in un'interfaccia per un gruppo, il gestore del gruppo multicast richiama questo callback al primo client per partecipare al gruppo.

Gestione gruppi multicast non richiama il callback per i join successivi al gruppo.

Gestione gruppi multicast usa la regola seguente per determinare quando richiamare questo callback per i join specifici dell'origine (s, g):

Se si tratta del primo client per informare il gestore gruppi multicast che sono presenti ricevitori in un'interfaccia per un'origine e un gruppo, il gestore del gruppo multicast richiama il callback PMGM_JOIN_ALERT_CALLBACK solo per il client che possiede l'interfaccia in ingresso verso l'origine "s".

Questa versione dell'API Multicast Group Manager supporta solo origini jolly (*, g) o origini specifiche (s, g), non un intervallo di origini. La stessa restrizione si applica ai gruppi, ovvero non sono consentiti intervalli di gruppi.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mgm.h

Share via