PMGM_CREATION_ALERT_CALLBACK función de devolución de llamada (mgm.h)

La devolución de llamada PMGM_CREATION_ALERT_CALLBACK es una llamada a un protocolo de enrutamiento. Esta llamada determina el subconjunto de interfaces que pertenecen al protocolo de enrutamiento en el que se debe reenviar un paquete de multidifusión desde un nuevo origen.

Cuando un paquete enviado desde un nuevo origen, o destinado a un nuevo grupo, llega a una interfaz, el administrador del grupo de multidifusión crea un nuevo MFE. A continuación, el administrador de grupos de multidifusión invoca esta devolución de llamada a los protocolos de enrutamiento que tienen interfaces salientes en esta nueva MFE. Un protocolo de enrutamiento puede optar por deshabilitar el reenvío de datos desde el origen al grupo en interfaces específicas.

Sintaxis

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

Parámetros

[in] dwSourceAddr

Especifica la dirección de origen desde la que se recibieron los datos de multidifusión. Cero indica que los datos se reciben 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 del grupo 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 con 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] dwInIfIndex

Especifica la interfaz en la que deben llegar los datos de multidifusión del origen.

[in] dwInIfNextHopAddr

Especifica la dirección del próximo salto que corresponde al índice especificado por dwIfIndex. Los parámetros dwIfIndex y dwIfNextHopIPAddr identifican de forma única un próximo salto en interfaces de punto a punto. Una interfaz de punto a punto es una conexión en la que una interfaz se conecta a varias redes. Algunos ejemplos de interfaces de punto a punto son interfaces de acceso múltiple (NBMA) que no son de difusión y la interfaz interna en la que se conectan todos los clientes de acceso telefónico.

Para las interfaces de difusión (como las interfaces Ethernet) o las interfaces de punto a punto, que solo se identifican mediante el valor de dwIfIndex, especifique cero.

[in] dwIfCount

Especifica el número de interfaces del búfer a las que apunta pmieOutIfList.

[in, out] pmieOutIfList

En la entrada, un puntero a un búfer que contiene el conjunto de interfaces propiedad del protocolo en el que se reenviarán los datos.

En la salida, el cliente puede establecer el miembro bIsEnabled de la estructura de MGM_IF_ENTRY correspondiente en FALSE para evitar el reenvío en cualquiera de sus interfaces. Es posible que no sea necesario un cliente para evitar el reenvío; este cliente aceptaría el valor predeterminado de bIsEnabled.

Valor devuelto

RRAS no espera que la aplicación devuelva ningún valor específico; RRAS omite cualquier valor devuelto.

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

Consulte también

MGM_IF_ENTRY