PMGM_CREATION_ALERT_CALLBACK funzione di callback (mgm.h)

Il callback PMGM_CREATION_ALERT_CALLBACK è una chiamata a un protocollo di routing. Questa chiamata determina il subset di interfacce di proprietà del protocollo di routing in cui deve essere inoltrato un pacchetto multicast da una nuova origine.

Quando un pacchetto inviato da una nuova origine o destinato a un nuovo gruppo arriva su un'interfaccia, il gestore del gruppo multicast crea un nuovo MFE. Il gestore del gruppo multicast richiama quindi questo callback a tali protocolli di routing con interfacce in uscita in questo nuovo MFE. Un protocollo di routing può scegliere di disabilitare l'inoltro dei dati dall'origine al gruppo su interfacce specifiche.

Sintassi

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

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] dwInIfIndex

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

[in] dwInIfNextHopAddr

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.

[in] dwIfCount

Specifica il numero di interfacce nel buffer a cui punta pmieOutIfList.

[in, out] pmieOutIfList

In input, un puntatore a un buffer che contiene il set di interfacce di proprietà del protocollo in cui verranno inoltrati i dati.

Nell'output, il client può impostare il membro bIsEnabled della struttura di MGM_IF_ENTRY corrispondente su FALSE per impedire l'inoltro su una delle relative interfacce. Un client potrebbe non essere necessario per impedire l'inoltro; tale client accetterebbe il valore predefinito di bIsEnabled.

Valore restituito

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

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

MGM_IF_ENTRY