GROUP_FILTER-Struktur (ws2ipdef.h)

Artikel
03/04/2024

Die GROUP_FILTER-Struktur stellt Multicastfilterparameter für Multicast-IPv6- oder IPv4-Adressen bereit.

Syntax

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;

Member

gf_interface

Der Schnittstellenindex der lokalen Schnittstelle für die zu filternde Multicastgruppe.

gf_group

Die Multicastadressgruppe, die gefiltert werden soll. Dies kann entweder eine IPv6- oder eine IPv4-Multicastadresse sein.

gf_fmode

Der Multicastfiltermodus.

Dieser Member kann einer der Werte aus dem MULTICAST_MODE_TYPE Enumerationstyp sein, der in der Ws2ipdef.h-Headerdatei definiert ist. Dieses Mitglied bestimmt, ob die Liste der IP-Adressen im gf_numsrc Mitglied eingeschlossen oder ausgeschlossen werden soll.

Wert	Bedeutung
MCAST_INCLUDE	Der Filter enthält eine Liste der IP-Adressen, die eingeschlossen werden sollen.
MCAST_EXCLUDE	Der Filter enthält eine Liste von IP-Adressen, die ausgeschlossen werden sollen.

gf_numsrc

Die Anzahl der Multicastfilter-Quelladresseinträge im gf_slist-Member .

gf_slist[1]

Ein Array von SOCKADDR_STORAGE Strukturen, die die Multicastquelladressen angeben, die ein- oder ausgeschlossen werden sollen. Diese IP-Adressen können entweder IPv6- oder IPv4-Adressen sein, aber sie müssen dieselbe Adressfamilie (IPv6 oder IPv4) wie die im gf_group-Member angegebene Adresse sein.

Hinweise

Die GROUP_FILTER-Struktur wird entweder mit IPv6- oder IPv4-Multicastadressen verwendet. Die GROUP_FILTER-Struktur wird als Argument für die IOCTLs SIOCGMSFILTER und SIOCSMSFILTER übergeben.

Die GROUP_FILTER Struktur und die damit verbundenen Strukturen, die für die Multicastprogrammierung verwendet werden, basieren auf IETF-Empfehlungen in den Abschnitten 5 und 8.2 von RFC 3768. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc3678.txt.

Unter Windows Vista und höher stehen eine Reihe von Socketoptionen für die Multicastprogrammierung zur Verfügung, die IPv6- und IPv4-Adressen unterstützen. Diese Socketoptionen sind IP-unabhängig und können sowohl für IPv6 als auch für IPv4 verwendet werden. Diese ip-unabhängigen Optionen verwenden die GROUP_REQ und die GROUP_SOURCE_REQ Strukturen und sind die bevorzugten Socketoptionen für die Multicastprogrammierung unter Windows Vista und höher.

Die GetAdaptersAddresses-Funktion kann verwendet werden, um Schnittstellenindexinformationen abzurufen, die für den gf_interface-Member erforderlich sind.

Die GROUP_FILTER-Struktur und die Ioctls, die diese Struktur verwenden, sind nur für Datagramme und Unformatierte Sockets gültig (der Sockettyp muss SOCK_DGRAM oder SOCK_RAW sein).

Die GROUP_FILTER-Struktur ist in der Ws2ipdef.h-Headerdatei definiert, die automatisch in der Ws2tcpip.h-Headerdatei enthalten ist. Die Ws2ipdef.h-Headerdateien sollten niemals direkt verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	ws2ipdef.h (include Ws2tcpip.h)