PMGM_JOIN_ALERT_CALLBACK función de devolución de llamada (mgm.h)
La devolución de llamada PMGM_JOIN_ALERT_CALLBACK es una llamada a un protocolo de enrutamiento para notificar al protocolo que los nuevos receptores están presentes para uno o varios grupos en interfaces que pertenecen a otros protocolos de enrutamiento. Una vez que un protocolo de enrutamiento recibe esta devolución de llamada, debe comenzar a reenviar datos de multidifusión para el origen y el grupo especificados.
Sintaxis
PMGM_JOIN_ALERT_CALLBACK PmgmJoinAlertCallback;
DWORD PmgmJoinAlertCallback(
[in] DWORD dwSourceAddr,
[in] DWORD dwSourceMask,
[in] DWORD dwGroupAddr,
[in] DWORD dwGroupMask,
[in] BOOL bMemberUpdate
)
{...}
Parámetros
[in] dwSourceAddr
Especifica la dirección de origen de la que se recibieron los datos de multidifusión. Cero indica que se reciben datos de todos los orígenes (un receptor comodín para un grupo); de lo contrario, el valor de dwSourceAddr es la dirección IP de la red de origen o de origen.
Para especificar un intervalo de direcciones de origen, el administrador de grupos de multidifusión especifica la red de origen mediante dwSourceAddr y especifica una máscara de subred mediante dwSourceMask.
[in] dwSourceMask
Especifica la máscara de subred que corresponde a dwSourceAddr. Los parámetros dwSourceAddr y dwSourceMask se usan juntos para definir un intervalo de orígenes desde los que se van a recibir datos de multidifusión.
El administrador de grupos de multidifusión especifica cero para este parámetro si también especificó cero para dwSourceAddr (un receptor de caracteres comodín).
[in] dwGroupAddr
Especifica el grupo de multidifusión para el que se destinan los datos. Cero indica que se reciben todos los grupos (un receptor comodín); de lo contrario, el valor de dwGroupAddr es la dirección IP del grupo.
Para especificar un intervalo de direcciones de grupo, el administrador de grupos de multidifusión especifica la dirección de grupo mediante dwGroupAddr y especifica una máscara de subred mediante dwGroupMask.
[in] dwGroupMask
Especifica la máscara de subred que corresponde a dwGroupAddr. Los parámetros dwGroupAddr y dwGroupMask se usan juntos para definir un intervalo de grupos de multidifusión.
El administrador de grupos de multidifusión especifica cero para este parámetro si también especificó cero para dwGroupAddr (un receptor con caracteres comodín).
[in] bMemberUpdate
Especifica si se invocó la devolución de llamada porque un cliente llamó a MgmAddGroupMembershipEntry (el administrador de grupos de multidifusión establece este parámetro en TRUE), o porque se creó o actualizó una MFE (el administrador del grupo de multidifusión establece este parámetro en FALSE).
Valor devuelto
RRAS no espera que la aplicación devuelva ningún valor específico; RRAS omite cualquier valor devuelto.
Comentarios
El administrador de grupos de multidifusión establece el parámetro bMemberUpdate en TRUE e invoca esta devolución de llamada si un cliente llama a la función MgmAddGroupMembershipEntry para una entrada (s, g), (, g) o (, *) (es decir, la pertenencia a grupos ha cambiado).
El administrador de grupos de multidifusión establece el parámetro bMemberUpdate en FALSE si cambia la lista de interfaz salientes de un MFE. Este cambio suele producirse para un cambio en la pertenencia al grupo correspondiente a la MFE.
Un protocolo de enrutamiento de multidifusión puede usar el parámetro bMemberUpdate para distinguir entre los cambios en la pertenencia a grupos y los cambios en MFE.
La acción realizada por el protocolo de enrutamiento cuando se recibe esta devolución de llamada es específica del protocolo. El protocolo puede omitir la devolución de llamada si el parámetro bMemberUpdate está establecido en FALSE, si la especificación del protocolo indica que este es el comportamiento correcto.
Cuando se llama a MgmAddGroupMembershipEntry , el administrador de grupos de multidifusión usa esta devolución de llamada para notificar a otros clientes del administrador de grupos de multidifusión que hay receptores para el origen y el grupo especificados.
El administrador de grupos de multidifusión usa las reglas siguientes para determinar cuándo invocar esta devolución de llamada para combinaciones con caracteres comodín (*, g):
- Si este es el primer cliente para informar al administrador del grupo de multidifusión que hay receptores en una interfaz para un grupo, el administrador de grupos de multidifusión invoca la devolución de llamada PMGM_JOIN_ALERT_CALLBACK a todos los demás clientes registrados.
- Si este es el segundo cliente para informar al administrador del grupo de multidifusión que hay receptores en una interfaz para un grupo, el administrador de grupos de multidifusión invoca esta devolución de llamada al primer cliente para unirse al grupo.
El administrador de grupos de multidifusión usa la siguiente regla para determinar cuándo invocar esta devolución de llamada para combinaciones específicas del origen (s, g):
- Si este es el primer cliente para informar al administrador de grupos de multidifusión que hay receptores en una interfaz para un origen y grupo, el administrador del grupo de multidifusión invoca la devolución de llamada PMGM_JOIN_ALERT_CALLBACK solo para el cliente que posee la interfaz entrante hacia el origen "s".
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mgm.h |