PMGM_JOIN_ALERT_CALLBACK funzione di callback (mgm.h)
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 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".
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Nessuno supportato |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | mgm.h |