PFN_WSK_RELEASE_DATA_INDICATION_LIST回呼函式 (wsk.h)

發行項
02/27/2024

WskRelease 函式會釋放先前由 WSK 應用程式保留之WSK_DATA_INDICATION結構的連結清單。

WskRelease 可以透過兩種不同的方式宣告，視套接字類型而定。本主題描述連接導向或接聽套接字的 WskRelease 。如需數據報套接字，請參閱 WskRelease (數據報套接字) 。

語法

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 代碼：

傳回碼	Description
STATUS_SUCCESS	已成功釋放緩衝區清單。
STATUS_INVALID_PARAMETER	指定了無效的參數。

備註

針對連接導向或接聽套接字，WSK 應用程式會呼叫 WskRelease 函式，藉由從 WskReceiveEvent 或其 WskReceiveFromEvent 事件回呼函式傳回 STATUS_PENDING先前保留的WSK_DATA_INDICATION結構連結清單。

藉由呼叫 WskCloseSocket 函式來關閉套接字，並不會釋放任何未完成的已保留結構連結清單。在應用程式呼叫 WskCloseSocket 函式以關閉套接字之前，WSK 應用程式必須釋放所有保留的結構連結清單。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	Universal
標頭	wsk.h (包含 Wsk.h)
IRQL	<= DISPATCH_LEVEL