PFN_WSK_RELEASE_DATA_INDICATION_LIST コールバック関数 (wsk.h)

[アーティクル]
03/05/2024

WskRelease 関数は、WSK アプリケーションによって以前に保持されていたWSK_DATA_INDICATION構造体のリンクされたリストを解放します。

WskRelease は、ソケットの種類に応じて、2 つの異なる方法で宣言できます。このトピックでは、接続指向ソケットまたはリッスンソケット用の 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 コードを返します。

リターンコード	説明
STATUS_SUCCESS	バッファーの一覧が正常に解放されました。
STATUS_INVALID_PARAMETER	無効なパラメーターが指定されました。

注釈

接続指向ソケットまたはリッスンソケットの場合、 WSK アプリケーションは WskRelease 関数を呼び出して、その WskReceiveEvent または WskReceiveFromEvent イベントコールバック関数からSTATUS_PENDINGを返すことによって、以前に保持していたWSK_DATA_INDICATION構造体のリンクされたリストを解放します。

WskCloseSocket 関数を呼び出してソケットを閉じても、保持されている未解決の構造体のリンクリストは解放されません。 WSK アプリケーションは、 WskCloseSocket 関数を呼び出してソケットを閉じる前に、保持されているすべての構造体のリンクリストを解放する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	wsk.h (Wsk.h を含む)
IRQL	<= DISPATCH_LEVEL