struttura GROUP_FILTER (ws2ipdef.h)

Articolo
03/13/2024

La struttura GROUP_FILTER fornisce parametri di filtro multicast per indirizzi IPv6 o IPv4 multicast.

Sintassi

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;

Members

gf_interface

Indice dell'interfaccia locale per il gruppo multicast da filtrare.

gf_group

Gruppo di indirizzi multicast da filtrare. Può trattarsi di un indirizzo multicast IPv6 o IPv4.

gf_fmode

Modalità filtro multicast.

Questo membro può essere uno dei valori del tipo di enumerazione MULTICAST_MODE_TYPE definito nel file di intestazione Ws2ipdef.h . Questo membro determina se l'elenco di indirizzi IP nel membro gf_numsrc deve essere incluso o escluso.

Valore	Significato
MCAST_INCLUDE	Il filtro contiene un elenco di indirizzi IP da includere.
MCAST_EXCLUDE	Il filtro contiene un elenco di indirizzi IP da escludere.

gf_numsrc

Numero di voci dell'indirizzo di origine del filtro multicast nel membro gf_slist .

gf_slist[1]

Matrice di strutture SOCKADDR_STORAGE che specificano gli indirizzi di origine multicast da includere o escludere. Questi indirizzi IP possono essere indirizzi IPv6 o IPv4, ma devono essere la stessa famiglia di indirizzi (IPv6 o IPv4) dell'indirizzo specificato nel membro gf_group .

Commenti

La struttura GROUP_FILTER viene usata con indirizzi multicast IPv6 o IPv4. La struttura GROUP_FILTER viene passata come argomento per gli IOCTL SIOCGMSFILTER e SIOCSMSFILTER .

La struttura GROUP_FILTER e le strutture correlate usate per la programmazione multicast si basano sulle raccomandazioni di IETF nelle sezioni 5 e 8.2 di RFC 3768. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc3678.txt.

In Windows Vista e versioni successive è disponibile un set di opzioni socket per la programmazione multicast che supporta gli indirizzi IPv6 e IPv4. Queste opzioni socket sono indipendenti dall'ip e possono essere usate sia in IPv6 che in IPv4. Queste opzioni indipendenti dall'IP usano la GROUP_REQ e le strutture GROUP_SOURCE_REQ e sono le opzioni socket preferite per la programmazione multicast in Windows Vista e versioni successive.

La funzione GetAdaptersAddresses può essere usata per ottenere le informazioni sull'indice dell'interfaccia necessarie per il membro gf_interface .

La struttura GROUP_FILTER e gli Ioctls che usano questa struttura sono validi solo per datagrammi e socket non elaborati (il tipo di socket deve essere SOCK_DGRAM o SOCK_RAW).

La struttura GROUP_FILTER è definita nel file di intestazione Ws2ipdef.h , incluso automaticamente nel file di intestazione Ws2tcpip.h . I file di intestazione Ws2ipdef.h non devono mai essere usati direttamente.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	ws2ipdef.h (include Ws2tcpip.h)