GROUP_FILTER 構造体 (ws2ipdef.h)

[アーティクル]
08/28/2023

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_REQ と GROUP_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 を含む)