次の方法で共有


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

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

こちらもご覧ください

WSK_DATAGRAM_INDICATION

WSK_DATA_INDICATION

WSK_PROVIDER_CONNECTION_DISPATCH

WSK_PROVIDER_STREAM_DISPATCH

WSK_SOCKET

WskCloseSocket

WskReceiveEvent

WskReceiveFromEvent