struktur GROUP_FILTER (ws2ipdef.h)

Artikel
08/28/2023

Struktur GROUP_FILTER menyediakan parameter pemfilteran multicast untuk alamat IPv6 atau IPv4 multicast.

Sintaks

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;

Anggota

gf_interface

Indeks antarmuka antarmuka lokal untuk memfilter grup multicast.

gf_group

Grup alamat multicast yang harus difilter. Ini mungkin alamat multicast IPv6 atau IPv4.

gf_fmode

Mode filter multicast.

Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi MULTICAST_MODE_TYPE yang ditentukan dalam file header Ws2ipdef.h . Anggota ini menentukan apakah daftar alamat IP dalam anggota gf_numsrc harus disertakan atau dikecualikan.

Nilai	Makna
MCAST_INCLUDE	Filter berisi daftar alamat IP yang akan disertakan.
MCAST_EXCLUDE	Filter berisi daftar alamat IP yang akan dikecualikan.

gf_numsrc

Jumlah entri alamat sumber filter multicast di anggota gf_slist .

gf_slist[1]

Array struktur SOCKADDR_STORAGE yang menentukan alamat sumber multicast untuk disertakan atau dikecualikan. Alamat IP ini mungkin alamat IPv6 atau IPv4, tetapi harus merupakan keluarga alamat yang sama (IPv6 atau IPv4) sebagai alamat yang ditentukan dalam anggota gf_group ..

Keterangan

Struktur GROUP_FILTER digunakan dengan alamat multicast IPv6 atau IPv4. Struktur GROUP_FILTER diteruskan sebagai argumen untuk SIOCGMSFILTER dan SIOCSMSFILTER IOCTLs.

Struktur GROUP_FILTER dan struktur terkait yang digunakan untuk pemrograman multicast didasarkan pada rekomendasi IETF di bagian 5 dan 8.2 RFC 3768. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc3678.txt.

Pada Windows Vista dan yang lebih baru, sekumpulan opsi soket tersedia untuk pemrograman multicast yang mendukung alamat IPv6 dan IPv4. Opsi soket ini adalah agnostik IP dan dapat digunakan pada IPv6 dan IPv4. Opsi agnostik IP ini menggunakan GROUP_REQ dan struktur GROUP_SOURCE_REQ dan merupakan opsi soket pilihan untuk pemrograman multicast di Windows Vista dan yang lebih baru.

Fungsi GetAdaptersAddresses dapat digunakan untuk mendapatkan informasi indeks antarmuka yang diperlukan untuk anggota gf_interface .

Struktur GROUP_FILTER dan Ioctls yang menggunakan struktur ini hanya valid pada datagram dan soket mentah (jenis soket harus SOCK_DGRAM atau SOCK_RAW).

Struktur GROUP_FILTER didefinisikan dalam file header Ws2ipdef.h yang secara otomatis disertakan dalam file header Ws2tcpip.h . File header Ws2ipdef.h tidak boleh digunakan secara langsung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	ws2ipdef.h (termasuk Ws2tcpip.h)