次の方法で共有


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

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

WskRelease は、ソケットの種類に応じて、2 つの異なる方法で宣言できます。 このトピックでは、データグラム ソケットの WskRelease について説明します。 接続指向またはリッスンソケットについては、「 WskRelease (接続指向またはリッスンソケット)」を参照してください。

構文

PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;

NTSTATUS PfnWskReleaseDatagramIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATAGRAM_INDICATION DatagramIndication
)
{...}

パラメーター

[in] Socket

データを受信したソケットのソケット オブジェクトを指定する WSK_SOCKET 構造体へのポインター。

[in] DatagramIndication

解放する構造体のリンクされたリストへのポインター。 このパラメーターの場合、WSK アプリケーションは、WskReceiveEvent または WskReceiveFromEvent イベント コールバック関数に渡された DatagramIndication パラメーターを指定する必要があります。

戻り値

WskRelease は、次のいずれかの NTSTATUS コードを返します。

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

注釈

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

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

要件

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

こちらもご覧ください

WSK_DATAGRAM_INDICATION

WSK_DATA_INDICATION

WSK_PROVIDER_DATAGRAM_DISPATCH

WSK_SOCKET

WskCloseSocket

WskReceiveEvent

WskReceiveFromEvent