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、RIOSend 和 RIOSendEx 函数的已注册 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) |