GROUP_SOURCE_REQ構造体 (ws2ipdef.h)

  • [アーティクル]

GROUP_SOURCE_REQ構造体は、送信元 IP アドレスを含む IPv6 または IPv4 アドレスのマルチキャスト グループ情報を提供します。

構文

typedef struct group_source_req {
  ULONG            gsr_interface;
  SOCKADDR_STORAGE gsr_group;
  SOCKADDR_STORAGE gsr_source;
} GROUP_SOURCE_REQ, *PGROUP_SOURCE_REQ;

メンバー

gsr_interface

マルチキャスト グループを参加、削除、ブロック、またはブロック解除する必要があるローカル インターフェイスのインターフェイス インデックス。

gsr_group

マルチキャスト グループのアドレス。 これは、IPv6 または IPv4 マルチキャスト アドレスのいずれかになります。

gsr_source

使用する必要があるソース アドレス。 これは IPv6 または IPv4 マルチキャスト アドレスのいずれかになりますが、 gsr_group メンバーで指定されたアドレスと同じアドレス ファミリ (IPv6 または IPv4) である必要があります。

解説

GROUP_SOURCE_REQ構造は、IPv6 または IPv4 マルチキャスト アドレスで使用されます。 GROUP_SOURCE_REQ構造体は、MCAST_BLOCK_SOURCE、MCAST_JOIN_SOURCE_GROUP、MCAST_LEAVE_SOURCE_GROUP、およびMCAST_UNBLOCK_SOURCEソケット オプションと共に使用されます。

マルチキャスト プログラミングに使用される GROUP_SOURCE_REQ 構造と関連する構造体は、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 関数を使用すると、gsr_interface メンバーに必要なインターフェイス インデックス情報を取得できます。

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

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

要件

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

関連項目

GROUP_FILTER

GROUP_REQ

GetAdaptersAddresses

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

SOCKADDR_STORAGE

ソケット オプション

ip_mreq

ipv6_mreq