PFN_WSK_RELEASE_DATA_INDICATION_LIST回调函数 (wsk.h)

项目
08/08/2023

WskRelease 函数释放以前由 WSK 应用程序保留的WSK_DATA_INDICATION结构的链接列表。

WskRelease 可以通过两种不同的方式声明，具体取决于套接字的类型。本主题介绍面向连接的或侦听套接字的 WskRelease 。有关数据报套接字，请参阅 WskRelease (datagram sockets) 。

语法

PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;

NTSTATUS PfnWskReleaseDataIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATA_INDICATION DataIndication
)
{...}

参数

[in] Socket

指向 WSK_SOCKET 结构的指针，该结构指定从中接收数据的套接字的套接字对象。

[in] DataIndication

指向要释放的结构的链接列表的指针。对于此参数，WSK 应用程序应指定传递给其 WskReceiveEvent 或 WskReceiveFromEvent 事件回调函数的 DataIndication 参数。

返回值

WskRelease 返回以下 NTSTATUS 代码之一：

返回代码	说明
STATUS_SUCCESS	已成功释放缓冲区列表。
STATUS_INVALID_PARAMETER	指定的参数无效。

注解

对于面向连接的套接字或侦听套接字，WSK 应用程序调用 WskRelease 函数以释放它以前通过从 WskReceiveEvent 或 WskReceiveFromEvent 事件回调函数返回STATUS_PENDING来保留的WSK_DATA_INDICATION结构的链接列表。

通过调用 WskCloseSocket 函数关闭套接字不会释放任何未完成的保留结构链接列表。在应用程序调用 WskCloseSocket 函数以关闭套接字之前，WSK 应用程序必须释放所有保留的结构链接列表。

要求

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台	通用
标头	wsk.h (包括 Wsk.h)
IRQL	<= DISPATCH_LEVEL