RIO_BUF 構造体 (mswsockdef.h)

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

RIO_BUF構造体は、Winsock 登録済み I/O 拡張機能を使用してネットワークデータを送受信するために使用される登録済みバッファーの一部を指定します。

構文

typedef struct _RIO_BUF {
  RIO_BUFFERID BufferId;
  ULONG        Offset;
  ULONG        Length;
} RIO_BUF, *PRIO_BUF;

メンバー

BufferId

送受信要求で使用される Winsock 登録済み I/O バッファーの登録済みバッファー記述子。

Offset

BufferId メンバーによって指定されたバッファーへのオフセット (バイト単位)。 0 の Offset 値はバッファーの先頭を指します

Length

Offset メンバーから使用するバッファーの長さ (バイト単位)。

注釈

Winsock 登録済み I/O 拡張機能は、多くの場合、登録されたバッファーの一部 (バッファースライスと呼ばれることもあります) で動作します。 RIO_BUF構造は、ネットワークデータの送受信に少量の登録済みメモリを使用する必要があるアプリケーションによって使用されます。アプリケーションでは、多くの場合、1 つの大きなバッファーを登録し、必要に応じてバッファーの小さなチャンクを使用することで、パフォーマンスを向上させることができます。 RIO_BUF構造体は、単一のバッファー登録に含まれるメモリの連続したセグメントを記述できます。

RIO_BUF構造体へのポインターは、ネットワーク データを送受信するために、RIOSend、RIOSendEx、RIOReceive、RIOReceiveEx 関数に pData パラメーターとして渡されます。

アプリケーションでは、 RIORegisterBuffer 関数を使用して登録された元のバッファーより大きい値を持つバッファースライスを使用するだけで、登録されたバッファーのサイズを変更することはできません。

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

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
Header	mswsockdef.h (Mswsock.h を含む)