PMGM_LOCAL_JOIN_CALLBACK função de retorno de chamada (mgm.h)

O retorno de chamada PMGM_LOCAL_JOIN_CALLBACK é uma chamada para um protocolo de roteamento para notificar o protocolo de que o IGMP detectou novos receptores para um grupo em uma interface que atualmente pertence ao protocolo de roteamento.

Esse retorno de chamada é invocado quando a função MgmAddGroupMembershipEntry é chamada pelo IGMP.

Sintaxe

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

Parâmetros

[in] dwSourceAddr

Especifica o endereço de origem do qual os dados multicast foram recebidos. Zero indica que os dados são recebidos de todas as fontes (um receptor curinga para um grupo); caso contrário, o valor de dwSourceAddr é o endereço IP da rede de origem ou de origem.

Para especificar um intervalo de endereços de origem, o gerenciador de grupo multicast especifica a rede de origem usando dwSourceAddr e especifica uma máscara de sub-rede usando dwSourceMask.

[in] dwSourceMask

Especifica a máscara de sub-rede que corresponde a dwSourceAddr. Os parâmetros dwSourceAddr e dwSourceMask são usados juntos para definir um intervalo de fontes das quais receber dados multicast.

O gerenciador de grupo multicast especifica zero para esse parâmetro se ele também especificou zero para dwSourceAddr (um receptor curinga).

[in] dwGroupAddr

Especifica o grupo multicast para o qual os dados estão destinados. Zero indica que todos os grupos são recebidos (um receptor curinga); caso contrário, o valor de dwGroupAddr é o endereço IP do grupo.

Para especificar um intervalo de endereços de grupo, o gerenciador de grupo multicast especifica o endereço do grupo usando dwGroupAddr e especifica uma máscara de sub-rede usando dwGroupMask.

[in] dwGroupMask

Especifica a máscara de sub-rede que corresponde a dwGroupAddr. Os parâmetros dwGroupAddr e dwGroupMask são usados juntos para definir um intervalo de grupos multicast.

O gerenciador de grupo multicast especifica zero para esse parâmetro se ele também especificou zero para dwGroupAddr (um receptor curinga).

[in] dwIfIndex

Especifica a interface na qual os dados multicast da origem devem chegar.

[in] dwIfNextHopAddr

Especifica o endereço do próximo salto que corresponde ao índice especificado por dwIfIndex. Os parâmetros dwIfIndex e dwIfNextHopIPAddr identificam exclusivamente um próximo salto em interfaces ponto a ponto. Uma interface ponto a ponto é uma conexão em que uma interface se conecta a várias redes. Exemplos de interfaces ponto a multipoint incluem interfaces NBMA (acesso múltiplo não difundido) e a interface interna na qual todos os clientes discados se conectam.

Para interfaces de difusão (como interfaces Ethernet) ou interfaces ponto a ponto, que são identificadas apenas pelo valor de dwIfIndex, especifique zero.

Retornar valor

O RRAS não espera que o aplicativo retorne nenhum valor específico; qualquer valor retornado é ignorado pelo RRAS.

Comentários

Esta versão da API do Gerenciador de Grupo multicast dá suporte apenas a fontes curinga (*, g) ou fontes específicas (s, g), não a um intervalo de fontes. A mesma restrição se aplica a grupos (ou seja, nenhum intervalo de grupo é permitido).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mgm.h

Confira também

PMGM_LOCAL_LEAVE_CALLBACK