(mswsockdef.h)

RIORESULT 結構包含用來指出與 Winsock 已註冊 I/O 延伸模組搭配使用的要求完成結果的數據。

語法

typedef struct _RIORESULT {
  LONG      Status;
  ULONG     BytesTransferred;
  ULONGLONG SocketContext;
  ULONGLONG RequestContext;
} RIORESULT, *PRIORESULT;

成員

Status

Winsock 已註冊 I/O 要求的完成狀態。

BytesTransferred

在 I/O 要求中傳送或接收的位元元組數目。

SocketContext

呼叫 RIOCreateRequestQueue 函式時所指定的應用程式提供內容。

RequestContext

以已註冊 I/O 要求指定給RIOReceive、RIOReceiveExRIOSendRIOSendEx 函式的應用程式提供內容。

備註

RIORESULT 結構會定義用來表示 Winsock 已註冊 I/O 延伸模組要求完成的數據格式。 應用程式要求完成指示的方式是配置 一個RIORESULT 結構的陣列,並將 此ARRAY的一組RIORESULT 結構連同專案計數一起傳遞至 RIODequeueCompletion 函 式。 應用程式在呼叫RIODequeueCompletion 函式之前,不需要執行任何一開始初始化的RIORESULT 結構元素。

一個應用程式可以使用RIORESULT結構的SocketContext成員來識別發出 Winsock 註冊 I/O 要求的RIO_CQ物件或相關聯的應用程式物件。 RIORESULT 結構的 RequestContext 成員同樣可用來識別已完成的特定 Winsock 註冊 I/O 要求。

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

規格需求

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

另請參閱

RIOCreateRequestQueue

RIODequeueCompletion

RIOReceive

RIOReceiveEx

RIOSend

RIOSendEx