estrutura GROUP_FILTER (ws2ipdef.h)
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 |
|---|---|
|
O filtro contém uma lista de endereços IP a serem incluídos. |
|
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) |