struktur GROUP_FILTER (ws2ipdef.h)
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 |
---|---|
|
Filter berisi daftar alamat IP yang akan disertakan. |
|
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) |