PFN_WSK_SEND_MESSAGES回调函数 (wsk.h)
WskSendMessages 函数将多个数据报发送到远程传输地址。
语法
PFN_WSK_SEND_MESSAGES PfnWskSendMessages;
NTSTATUS PfnWskSendMessages(
[in] PWSK_SOCKET Socket,
[in] PWSK_BUF_LIST BufferList,
ULONG Flags,
[in, optional] PSOCKADDR RemoteAddress,
[in] ULONG ControlInfoLength,
[In_reads_bytes_opt] PCMSGHDR ControlInfo,
[in, out] PIRP Irp
)
{...}
参数
[in] Socket
指向 WSK_SOCKET 结构的指针,该结构指定要从中发送数据报的套接字对象。
[in] BufferList
指向包含要发送的数据报列表的初始化 WSK_BUF_LIST 结构的指针。
Flags
[保留]此参数保留供系统使用。 WSK 应用程序必须将此参数设置为 零。
[in, optional] RemoteAddress
指向指定要向其发送数据报的远程传输地址的结构的指针。
[in] ControlInfoLength
ControlInfo 参数指向的缓冲区中的数据字节数。 如果没有与数据报关联的控件信息,ControlInfoLength 参数必须 零。
[In_reads_bytes_opt] ControlInfo
指向包含与要发送的数据报关联的控件信息的缓冲区的指针。 控件信息数据由一个或多个控件数据对象组成,每个对象以 CMSGHDR 结构开头。 如果没有与数据报关联的控制信息,则此参数应 NULL。
所有传输都可能不支持 ControlInfo。
[in, out] Irp
指向 WSK 子系统用于异步完成发送作的调用方分配的 IRP 的指针。 有关将 IRP 与 WSK 函数配合使用的详细信息,请参阅 将 IRP 与 Winsock 内核函数配合使用。
返回值
返回代码 | 描述 |
---|---|
STATUS_SUCCESS | 数据报已成功通过套接字发送。 IRP 将以成功状态完成。 IRP IoStatus.Information 字段包含已发送的字节数。 |
STATUS_PENDING | WSK 子系统无法立即通过套接字发送数据报。 WSK 子系统在通过套接字发送数据报后将完成 IRP。 发送作的状态将在 IRP 的 IoStatus.Status 字段中返回。 如果作成功,则 IRP IoStatus.Information 字段将包含已发送的字节数。 |
其他状态代码 | 发生错误。 IRP 将以失败状态完成。 |
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 8 |
标头 | wsk.h (包括 wsk.h) |