IP_MREQ 構造体 (ws2ipdef.h)

[アーティクル]
03/04/2024

ip_mreq構造体は、IPv4 アドレスのマルチキャストグループ情報を提供します。

構文

typedef struct ip_mreq {
  IN_ADDR imr_multiaddr;
  IN_ADDR imr_interface;
} IP_MREQ, *PIP_MREQ;

メンバー

imr_multiaddr

IPv4 マルチキャストグループのアドレス。

imr_interface

マルチキャストグループを参加または削除する必要があるインターフェイスまたはインターフェイスインデックスのローカル IPv4 アドレス。この値は、ネットワークのバイト順です。このメンバーが 0.0.0.0.0 の IPv4 アドレスを指定する場合は、既定の IPv4 マルチキャストインターフェイスが使用されます。

インターフェイスインデックス 1 を使用するには、IP アドレス 0.0.0.1 と同じになります。

注釈

ip_mreq構造体は、IPv4 アドレスと共に使用されます。 ip_mreq構造体は、IP_ADD_MEMBERSHIP および IP_DROP_MEMBERSHIP ソケットオプションと共に使用されます。

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

IPv4 で構成可能なマルチキャスト機能を追加する場合は、 ip_mreq_source 構造を使用します。詳細については、「マルチキャストプログラミング」を参照してください。

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

ip_mreq構造体は、IPv6 ベースのipv6_mreq構造体と同等の IPv4 です。

imr_interface メンバーにはインターフェイスインデックスを指定できます。 0.x.x.x ブロック内の IP アドレス (0 の最初のオクテット) (0.0.0.0 の IP アドレスを除く) は、インターフェイスインデックスとして扱われます。インターフェイスインデックスは 24 ビット番号です。 0.0.0.0/8 IPv4 アドレスブロックは使用されません (この範囲は予約されています)。 GetAdaptersAddresses 関数を使用すると、imr_interface メンバーに使用するインターフェイスインデックス情報を取得できます。

ローカル IPv4 アドレスまたはインターフェイスインデックスは、既定のインターフェイスを使用するのではなく、ip_mreq構造体の imr_interface メンバーで常に指定することをお勧めします。これは、複数のネットワークインターフェイスと複数のパブリック IPv4 アドレスを持つコンピューターで特に重要です。

IPv4 マルチキャストに使用される既定のインターフェイスは、Windows のネットワークスタックによって決まります。アプリケーションは、 GetIpForwardTable 関数を使用して IPv4 ルーティングテーブルを取得する IPv4 マルチキャストに使用される既定のインターフェイスを決定できます。宛先 IP アドレスのルーティングメトリックの値が 224.0.0.0 のネットワークインターフェイスは、IPv4 マルチキャストの既定のインターフェイスです。次のコマンドを使用して、コマンドプロンプトからルーティングテーブルを表示することもできます。

route print

IP_MULTICAST_IF ソケットオプションを使用して、IPv4 マルチキャストパケットを送信する既定のインターフェイスを設定できます。このソケットオプションでは、IPv4 マルチキャストパケットの受信に使用される既定のインターフェイスは変更されません。

一般的な IPv4 マルチキャストアプリケーションでは、 IP_ADD_MEMBERSHIP ソケットオプションと ip_mreq 構造を使用して、マルチキャストグループに参加し、特定のインターフェイスでマルチキャストパケットをリッスンします。 IP_MULTICAST_IF ソケットオプションを使用して、IPv4 マルチキャストパケットをマルチキャストグループに送信するインターフェイスを設定します。最も一般的なシナリオは、マルチキャストグループに対して同じインターフェイスでリッスンして送信するマルチキャストアプリケーションです。 1 つのソケットをリッスンし、1 つ以上のソケットを送信するマルチキャストアプリケーションで、複数のソケットを使用できます。

Windows Vista 以降用にリリースされた Microsoft Windows ソフトウェア開発キット (Windows SDK) (SDK) では、ヘッダーファイルのorganizationが変更され、ws2ipdef.h ヘッダーファイルに自動的に含まれる Ws2ipdef.h ヘッダーファイルにip_mreq構造が定義されています。 Ws2ipdef.h ヘッダーファイルを直接使用しないでください。

メモIP_MREQおよびPIP_MREQ派生構造体は、Windows Vista 以降でリリースされたWindows SDKでのみ定義されます。 ip_mreq構造体は、以前のバージョンのWindows SDKで使用する必要があります。

要件

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