次の方法で共有


GROUP_FILTER 構造体 (ws2ipdef.h)

GROUP_FILTER構造体は、マルチキャスト IPv6 または IPv4 アドレスのマルチキャスト フィルタリング パラメーターを提供します。

構文

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;

メンバー

gf_interface

マルチキャスト グループがフィルター処理するローカル インターフェイスのインターフェイス インデックス。

gf_group

フィルター処理する必要があるマルチキャスト アドレス グループ。 これは、IPv6 または IPv4 マルチキャスト アドレスのいずれかです。

gf_fmode

マルチキャスト フィルター モード。

このメンバーには、Ws2ipdef.h ヘッダー ファイルで定義されているMULTICAST_MODE_TYPE列挙型の値のいずれかを指定できます。 このメンバーは、 gf_numsrc メンバー内の IP アドレスの一覧を含めるか除外するかを決定します。

意味
MCAST_INCLUDE
フィルターには、含める IP アドレスの一覧が含まれます。
MCAST_EXCLUDE
フィルターには、除外する IP アドレスの一覧が含まれています。

gf_numsrc

gf_slist メンバー内のマルチキャスト フィルター ソース アドレス エントリの数。

gf_slist[1]

含める、または除外するマルチキャスト ソース アドレスを指定するSOCKADDR_STORAGE構造体の配列。 これらの IP アドレスは IPv6 アドレスまたは IPv4 アドレスのいずれかになりますが、 gf_group メンバーで指定されたアドレスと同じアドレス ファミリ (IPv6 または IPv4) である必要があります。

注釈

GROUP_FILTER構造体は、IPv6 または IPv4 マルチキャスト アドレスで使用されます。 GROUP_FILTER構造体は、SIOCGMSFILTER および SIOCSMSFILTER IOCTL の引数として渡されます。

マルチキャスト プログラミングに使用される GROUP_FILTER 構造と関連構造体は、RFC 3768 のセクション 5 と 8.2 の IETF の推奨事項に基づいています。 詳細については、「http://www.ietf.org/rfc/rfc3678.txt」を参照してください。

Windows Vista 以降では、IPv6 アドレスと IPv4 アドレスをサポートするマルチキャスト プログラミングに一連のソケット オプションを使用できます。 これらのソケット オプションは IP に依存せず、IPv6 と IPv4 の両方で使用できます。 これらの IP に依存しないオプションでは 、GROUP_REQGROUP_SOURCE_REQ 構造が使用され、Windows Vista 以降でのマルチキャスト プログラミングに推奨されるソケット オプションです。

GetAdaptersAddresses 関数を使用すると、gf_interface メンバーに必要なインターフェイス インデックス情報を取得できます。

この構造体を使用するGROUP_FILTER構造体と Ioctl は、データグラムソケットと生ソケットでのみ有効です (ソケットの種類はSOCK_DGRAMまたはSOCK_RAWである必要があります)。

GROUP_FILTER構造体は Ws2ipdef.h ヘッダー ファイルで定義され、Ws2tcpip.h ヘッダー ファイルに自動的に含まれます。 Ws2ipdef.h ヘッダー ファイルを直接使用しないでください。

要件

要件
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header ws2ipdef.h (Ws2tcpip.h を含む)

こちらもご覧ください

GROUP_REQ

GROUP_SOURCE_REQ

GetAdaptersAddresses

MULTICAST_MODE_TYPE

マルチキャスト プログラミング

SOCKADDR_STORAGE

ソケット オプション

ip_mreq

ip_msfilter

ipv6_mreq