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

  • Artigo

O retorno de chamada PMGM_ENABLE_IGMP_CALLBACK é uma chamada para IGMP para notificá-lo de que um protocolo de roteamento terminou de assumir ou liberar a propriedade de uma interface.

Quando esse retorno de chamada é invocado, o IGMP deve adicionar todas as suas associações de grupo na interface especificada usando chamadas para a função MgmAddGroupMembershipEntry .

Sintaxe

PMGM_ENABLE_IGMP_CALLBACK PmgmEnableIgmpCallback;

DWORD PmgmEnableIgmpCallback(
  [in] DWORD dwIfIndex,
  [in] DWORD dwIfNextHopAddr
)
{...}

Parâmetros

[in] dwIfIndex

Especifica o índice da interface na qual habilitar o IGMP.

[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 multipoint. Uma interface ponto a ponto é uma conexão em que uma interface se conecta a várias redes. Exemplos de interfaces ponto a multiponto 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

O IGMP não deve adicionar associações de grupo no contexto desse retorno de chamada. O gerenciador de grupo multicast e o IGMP ficam em deadlock.

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_DISABLE_IGMP_CALLBACK