estrutura GROUP_FILTER (ws2ipdef.h)

Artigo
03/13/2024

A estrutura GROUP_FILTER fornece parâmetros de filtragem multicast para endereços IPv6 ou IPv4 multicast.

Sintaxe

typedef struct group_filter {
  ULONG               gf_interface;
  SOCKADDR_STORAGE    gf_group;
  MULTICAST_MODE_TYPE gf_fmode;
  ULONG               gf_numsrc;
  SOCKADDR_STORAGE    gf_slist[1];
} GROUP_FILTER, *PGROUP_FILTER;

Membros

gf_interface

O índice de interface da interface local para o grupo multicast a ser filtrado.

gf_group

O grupo de endereços multicast que deve ser filtrado. Pode ser um endereço multicast IPv6 ou IPv4.

gf_fmode

O modo de filtro multicast.

Esse membro pode ser um dos valores do tipo de enumeração MULTICAST_MODE_TYPE definido no arquivo de cabeçalho Ws2ipdef.h . Esse membro determina se a lista de endereços IP no membro gf_numsrc deve ser incluída ou excluída.

Valor	Significado
MCAST_INCLUDE	O filtro contém uma lista de endereços IP a serem incluídos.
MCAST_EXCLUDE	O filtro contém uma lista de endereços IP a serem excluídos.

gf_numsrc

O número de entradas de endereço de origem do filtro multicast no membro gf_slist .

gf_slist[1]

Uma matriz de estruturas SOCKADDR_STORAGE especificando os endereços de origem multicast a serem incluídos ou excluídos. Esses endereços IP podem ser endereços IPv6 ou IPv4, mas devem ser a mesma família de endereços (IPv6 ou IPv4) que o endereço especificado no membro gf_group ..

Comentários

A estrutura GROUP_FILTER é usada com endereços multicast IPv6 ou IPv4. A estrutura GROUP_FILTER é passada como um argumento para as IOCTLs SIOCGMSFILTER e SIOCSMSFILTER .

A estrutura GROUP_FILTER e as estruturas relacionadas usadas para programação multicast são baseadas em recomendações de IETF nas seções 5 e 8.2 do RFC 3768. Para obter mais informações, consulte http://www.ietf.org/rfc/rfc3678.txt.

No Windows Vista e posteriores, um conjunto de opções de soquete está disponível para programação multicast que dá suporte a endereços IPv6 e IPv4. Essas opções de soquete são independentes de IP e podem ser usadas no IPv6 e no IPv4. Essas opções independentes de IP usam o GROUP_REQ e as estruturas de GROUP_SOURCE_REQ e são as opções de soquete preferenciais para programação multicast no Windows Vista e posterior.

A função GetAdaptersAddresses pode ser usada para obter informações de índice de interface necessárias para o membro gf_interface .

A estrutura GROUP_FILTER e os Ioctls que usam essa estrutura só são válidos em datagrama e soquetes brutos (o tipo de soquete deve ser SOCK_DGRAM ou SOCK_RAW).

A estrutura GROUP_FILTER é definida no arquivo de cabeçalho Ws2ipdef.h que é incluído automaticamente no arquivo de cabeçalho Ws2tcpip.h . Os arquivos de cabeçalho Ws2ipdef.h nunca devem ser usados diretamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	ws2ipdef.h (include Ws2tcpip.h)