Share via

PMGM_LOCAL_JOIN_CALLBACK funzione di callback (mgm.h)

  • Articolo

Il callback PMGM_LOCAL_JOIN_CALLBACK è una chiamata a un protocollo di routing per notificare al protocollo che IGMP ha rilevato nuovi ricevitori per un gruppo in un'interfaccia attualmente di proprietà del protocollo di routing.

Questo callback viene richiamato quando la funzione MgmAddGroupMembershipEntry viene chiamata da IGMP.

Sintassi

PMGM_LOCAL_JOIN_CALLBACK PmgmLocalJoinCallback;

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

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 con caratteri 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 tramite dwSourceAddr e specifica una subnet mask tramite dwSourceMask.

[in] dwSourceMask

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

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

[in] dwGroupAddr

Specifica il gruppo multicast per il quale i dati sono destinati. Zero indica che tutti i gruppi vengono ricevuti (un 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 tramite dwGroupAddr e specifica una subnet mask tramite dwGroupMask.

[in] dwGroupMask

Specifica la subnet mask che corrisponde 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] dwIfIndex

Specifica l'interfaccia in cui devono arrivare i dati multicast dall'origine.

[in] dwIfNextHopAddr

Specifica l'indirizzo dell'hop successivo che corrisponde all'indice specificato da dwIfIndex. I parametri dwIfIndex e dwIfNextHopIPAddr identificano in modo univoco un hop successivo sulle interfacce da punto a più punti. Un'interfaccia da punto a punto è una connessione in cui un'interfaccia si connette a più reti. Esempi di interfacce da punto a più punti includono interfacce di accesso multiplo (NBMA) non broadcast e l'interfaccia interna in cui si connettono tutti i client di connessione remota.

Per le interfacce di trasmissione (ad esempio interfacce Ethernet) o interfacce da punto a punto, identificate solo dal valore di dwIfIndex, specificano zero.

Valore restituito

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

Commenti

Questa versione dell'API Gestione gruppi multicast supporta solo origini con caratteri 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

Vedi anche

PMGM_LOCAL_LEAVE_CALLBACK