estructura GROUP_FILTER (ws2ipdef.h)

Artículo
08/28/2023

La estructura de GROUP_FILTER proporciona parámetros de filtrado de multidifusión para direcciones IPv6 o IPv4 de multidifusión.

Sintaxis

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;

Miembros

gf_interface

Índice de interfaz de la interfaz local del grupo de multidifusión que se va a filtrar.

gf_group

Grupo de direcciones de multidifusión que se debe filtrar. Puede ser una dirección de multidifusión IPv6 o IPv4.

gf_fmode

Modo de filtro de multidifusión.

Este miembro puede ser uno de los valores del tipo de enumeración MULTICAST_MODE_TYPE definido en el archivo de encabezado Ws2ipdef.h . Este miembro determina si la lista de direcciones IP del miembro gf_numsrc debe incluirse o excluirse.

Valor	Significado
MCAST_INCLUDE	El filtro contiene una lista de direcciones IP que se van a incluir.
MCAST_EXCLUDE	El filtro contiene una lista de direcciones IP que se van a excluir.

gf_numsrc

Número de entradas de dirección de origen del filtro de multidifusión en el miembro gf_slist .

gf_slist[1]

Matriz de SOCKADDR_STORAGE estructuras que especifican las direcciones de origen de multidifusión que se van a incluir o excluir. Estas direcciones IP pueden ser direcciones IPv6 o IPv4, pero deben ser la misma familia de direcciones (IPv6 o IPv4) que la dirección especificada en el miembro gf_group .

Comentarios

La estructura de GROUP_FILTER se usa con direcciones de multidifusión IPv6 o IPv4. La estructura GROUP_FILTER se pasa como argumento para los IOCTLs SIOCGMSFILTER y SIOCSMSFILTER .

La estructura GROUP_FILTER y las estructuras relacionadas usadas para la programación de multidifusión se basan en las recomendaciones de IETF en las secciones 5 y 8.2 de RFC 3768. Para obtener más información, vea http://www.ietf.org/rfc/rfc3678.txt.

En Windows Vista y versiones posteriores, hay disponible un conjunto de opciones de socket para la programación de multidifusión que admite direcciones IPv6 e IPv4. Estas opciones de socket son independientes de IP y se pueden usar en IPv6 e IPv4. Estas opciones independientes de IP usan las GROUP_REQ y las estructuras de GROUP_SOURCE_REQ y son las opciones de socket preferidas para la programación de multidifusión en Windows Vista y versiones posteriores.

La función GetAdaptersAddresses se puede usar para obtener información de índice de interfaz necesaria para el miembro gf_interface .

La estructura de GROUP_FILTER y los Ioctl que usan esta estructura solo son válidos en datagramas y sockets sin formato (el tipo de socket debe ser SOCK_DGRAM o SOCK_RAW).

La estructura GROUP_FILTER se define en el archivo de encabezado Ws2ipdef.h que se incluye automáticamente en el archivo de encabezado Ws2tcpip.h . Los archivos de encabezado Ws2ipdef.h nunca se deben usar directamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	ws2ipdef.h (incluya Ws2tcpip.h)