IPPROTO_UDP ソケット オプション

  • [アーティクル]

次の表では、UDP ( IPPROTO_UDP ) として指定されたソケット関数の プロトコル パラメーターを使用して、IPv4 アドレス ファミリと IPv6 アドレス ファミリ (AF_INET および AF_INET6) 用に作成されたソケットに適用される ソケット オプションIPPROTO_UDP説明します。 ソケット オプションの取得と設定の詳細については、 getsockopt および setsockopt 関数のリファレンス ページを参照してください。

プロトコルを列挙し、インストールされている各プロトコルでサポートされているプロパティを検出するには、 WSAEnumProtocols、 WSCEnumProtocols、または WSCEnumProtocols32 関数を使用します。

オプション

オプション 取得 オン Optval 型 説明
UDP_CHECKSUM_COVERAGE (ws2tcpip.h) はい はい DWORD (ブール値) TRUE の場合、UDP データグラムはチェックサムと共に送信されます。
UDP_NOCHECKSUM (ws2tcpip.h) はい はい DWORD (ブール値) TRUE の場合、UDP データグラムはチェックサム 0 で送信されます。 サービス プロバイダーに必要です。 サービス プロバイダーに UDP チェックサム計算を無効にするメカニズムがない場合は、アクションを実行せずにこのオプションを格納するだけで済みます。 このオプションは IPv6 ではサポートされていません。
UDP_RECV_MAX_COALESCED_SIZE (ws2ipdef.h;include ws2tcpip.h) はい はい DWORD 0 以外の値に設定すると、アプリケーションに指示される前に、複数の受信データグラムが 1 つのメッセージ バッファーに結合される可能性があります。 オプション値は、アプリケーションに示すことができる結合されたメッセージの最大メッセージ サイズ (バイト単位) を表します。 オプション値より大きい結合されていないメッセージは、引き続き示される場合があります。 既定値は 0 (合体なし) です。 データグラムは、同じ送信元アドレスとポートから送信された場合にのみ結合されます。 結合されたすべてのデータグラムは同じサイズになります。ただし、最後のデータグラムは小さい場合があります。 統合されたデータグラムのサイズ (最後のデータグラムとは異なる場合がある場合を除く) をアプリケーションで取得する場合は、制御情報 ( LPFN_WSARECVMSG (WSARecvMsg) など) をサポートする受信 API を使用する必要があります。 最後のメッセージ以外のすべてのサイズは、 DWORD 型の UDP_COALESCED_INFO コントロール メッセージにあります。 型の安全性を確保するために、アプリケーションでは、ソケット オプションの代わりに WSAGetUdpRecvMaxCoalescedSize 関数と WSASetUdpRecvMaxCoalescedSize 関数を直接使用する必要があります。
UDP_SEND_MSG_SIZE (ws2ipdef.h;include ws2tcpip.h) はい はい DWORD 0 以外の値に設定すると、アプリケーションによって送信されるバッファーは、ネットワーク スタックによって複数のメッセージに分割されます。 オプション値は、各分割されたメッセージのサイズを表します。 オプション値はバイト単位で表されます。 最後のセグメントのサイズは、 オプションの値より小さい場合があります。 既定値は 0 (セグメント化なし) です。 アプリケーションでは、IP の断片化を回避するために、宛先へのパスの MTU よりも小さい値を設定する必要があります。 型の安全性を確保するために、アプリケーションでは、ソケット オプションの代わりに WSAGetUdpSendMessageSize 関数と WSASetUdpSendMessageSize 関数を直接使用する必要があります。

IPPROTO_UDP オプションに対する従来の Windows サポート

UDP_CHECKSUM_COVERAGE は、Windows 2000 および Windows NT4 では使用できません。 Windows 9x/Me では、 UDP_CHECKSUM_COVERAGEとUDP_NOCHECKSUM は使用できません。

注釈

Windows Vista 以降用にリリースされた Microsoft Windows ソフトウェア開発キット (SDK) では、ヘッダー ファイルのorganizationが変更され、IPPROTO_UDP レベルは、Winsock2.h ヘッダー ファイルに自動的に含まれる Ws2def.h ヘッダー ファイルで定義されています。 IPPROTO_UDP ソケット オプションは、Ws2tcpip.h ヘッダー ファイルで定義されています。 Ws2def.h ヘッダー ファイルを直接使用しないでください。

要件

要件 値
ヘッダー
ws2ipdef.h (ws2tcpip.h を含む)、および ws2tcpip.h
Windows Server 2003、Windows XP、Windows 2000 の Winsock2.h