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