estructura GROUP_FILTER (ws2ipdef.h)
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 |
|---|---|
|
El filtro contiene una lista de direcciones IP que se van a incluir. |
|
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) |