RIO_BUF 結構 (mswsockdef.h)

發行項
02/29/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 成員所指定的緩衝區位移，以位元組為單位。緩衝區開頭的位移值零點

Length

要從 Offset 成員使用的緩衝區長度，以位元組為單位。

備註

Winsock 已註冊的 I/O 延伸模組通常會在已註冊緩衝區的部分上運作，有時稱為緩衝區配量。 RIO_BUF結構是由需要使用少量已註冊記憶體來傳送或接收網路數據的應用程式使用。應用程式通常會藉由註冊一個大型緩衝區，然後視需要使用小型緩衝區區塊來提升效能。 RIO_BUF 結構可能會描述單一緩衝區註冊中包含的任何連續記憶體區段。

RIO_BUF結構的指標會當做 pData 參數傳遞至RIOSend、RIOSendEx、RIOReceive 和RIOReceiveEx 函式，以傳送或接收網路數據。

應用程式只能藉由使用大於使用RIORegisterBuffer 函式註冊之原始緩衝區的值，調整已註冊緩衝區的大小。

RIO_BUF結構定義於 Mswsockdef.h 頭檔中，該頭檔會自動包含在 Mswsock.h 頭檔中。不應直接使用 Mswsockdef.h 頭檔。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
標頭	mswsockdef.h (包含 Mswsock.h)