RIORESULT 结构 (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

使用对 RIOReceive、RIOReceiveEx、RIOSendRIOSendEx 函数的已注册 I/O 请求指定的应用程序提供的上下文

注解

RIORESULT 结构定义用于指示 Winsock 注册 I/O 扩展完成请求的数据格式。 应用程序通过分配 RIORESULT 结构的数组并将 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