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

[アーティクル]
02/07/2025

WskAcceptEvent イベントコールバック関数は、リッスンしているソケット上の受信接続が受け入れられたことを WSK アプリケーションに通知します。

構文

PFN_WSK_ACCEPT_EVENT PfnWskAcceptEvent;

NTSTATUS PfnWskAcceptEvent(
  [in, optional] PVOID SocketContext,
  [in]           ULONG Flags,
  [in]           PSOCKADDR LocalAddress,
  [in]           PSOCKADDR RemoteAddress,
  [in, optional] PWSK_SOCKET AcceptSocket,
  [out]          PVOID *AcceptSocketContext,
  [out]          const WSK_CLIENT_CONNECTION_DISPATCH **AcceptSocketDispatch
)
{...}

パラメーター

[in, optional] SocketContext

受信接続が受け入れられたリッスンソケットのソケットコンテキストへのポインター。 WSK アプリケーションは、WskSocket 関数を呼び出してリッスンソケットを作成するときに、このポインターを WSK サブシステムに提供しました。

[in] Flags

次のフラグまたはゼロを含む ULONG 値。

WSK_FLAG_AT_DISPATCH_LEVEL

WSK サブシステムは、IRQL = DISPATCH_LEVEL でイベントコールバック関数 WskAcceptEvent を呼び出しました。このフラグが設定されていない場合、WSK サブシステムは、IRQL <= DISPATCH_LEVELでイベントコールバック関数 WskAcceptEvent を呼び出している可能性があります。

[in] LocalAddress

受信接続が到着したローカルトランスポートアドレスを格納しているバッファーへのポインター。バッファーには、WSK アプリケーションがリッスンソケットの作成時に指定したアドレスファミリに対応する特定の SOCKADDR 構造体型が含まれています。

[in] RemoteAddress

受信接続の送信元のリモートトランスポートアドレスを含むバッファーへのポインター。バッファーには、WSK アプリケーションがリッスンソケットの作成時に指定したアドレスファミリに対応する特定の SOCKADDR 構造体型が含まれています。

[in, optional] AcceptSocket

受け入れられたソケットのソケットオブジェクトである WSK_SOCKET 構造体へのポインター。このポインターが NULL 場合、リッスンソケットは機能しなくなり、WSK アプリケーションは WskCloseSocket 関数を呼び出して、できるだけ早くリッスンソケットを閉じる必要があります。

[out] AcceptSocketContext

受け入れられているソケットの WSK アプリケーション提供のコンテキストへのポインターを受け取る変数へのポインター。 WSK サブシステムは、このポインターを受け入れたソケットのイベントコールバック関数に渡します。コンテキスト情報は WSK サブシステムに対して不透明であり、非ページメモリに格納する必要があります。 WSK アプリケーションが受け入れられたソケットでイベントコールバック関数を有効にしない場合、アプリケーションは、AcceptSocketContext パラメーターが指す変数を NULL 設定する必要があります。

[out] AcceptSocketDispatch

定数へのポインターを受け取る変数へのポインター WSK_CLIENT_CONNECTION_DISPATCH 構造体。この構造体は、受け入れられたソケットのイベントコールバック関数へのポインターを含むディスパッチテーブルです。 WSK アプリケーションが受け入れられたソケットのすべてのイベントコールバック関数を有効にしない場合、アプリケーションはディスパッチテーブル内のポインターを、有効にしないイベントコールバック関数に対して NULL をするように設定する必要があります。 WSK アプリケーションが受け入れられたソケットでイベントコールバック関数を有効にしない場合は、AcceptSocketDispatch パラメーターが指す変数を NULL 設定する必要があります。

戻り値

WSK アプリケーションの WskAcceptEvent イベントコールバック関数は、次のいずれかの NTSTATUS コードを返すことができます。

リターンコード	形容
STATUS_SUCCESS	WSK アプリケーションが受信接続を受け入れた。
STATUS_REQUEST_NOT_ACCEPTED	WSK アプリケーションが受信接続を拒否しました。この値が返された場合、WSK サブシステムは WSK アプリケーションの代わりに受け入れられたソケットを閉じます。

備考

WSK サブシステムは、イベントコールバック関数が以前に SO_WSK_EVENT_CALLBACK ソケットオプションで有効になっていた場合にのみ、リッスンソケットで受信接続が受け入れられると、WSK アプリケーションの WskAcceptEvent イベントコールバック関数を呼び出します。ソケットのイベントコールバック関数の有効化の詳細については、「イベントコールバック関数の有効化と無効化」を参照してください。

WSK アプリケーションの WskAcceptEvent イベントコールバック関数がリッスンソケットで有効になっていて、アプリケーションが同じリッスンソケットで WskAccept 関数の保留中の呼び出しを行っている場合、受信接続が到着すると、WskAccept への保留中の呼び出 し WskAcceptEvent イベントコールバック関数よりも優先されます。 WSK サブシステムは、WskAccept 関数の保留中の呼び出しからキューに登録された IRP がない場合にのみ、アプリケーションの WskAcceptEvent イベントコールバック関数を呼び出します。ただし、WSK アプリケーションでは、wskAccept 関数の 呼び出しが保留中のリッスンソケットに対して、WSK サブシステムがアプリケーションの WskAcceptEvent イベントコールバック関数を呼び出さないと想定しないでください。 WSK サブシステムが WSK アプリケーションの WskAcceptEvent ソケットのイベントコールバック関数を呼び出すことができる競合状態が存在します。 WSK アプリケーションで、WSK サブシステムがリッスンソケットに対してアプリケーションの WskAcceptEvent イベントコールバック関数を呼び出さない唯一の方法は、ソケットでアプリケーションの WskAcceptEvent イベントコールバック関数を無効にすることです。

WSK サブシステムが WSK アプリケーションの WskAcceptEvent イベントコールバック関数を呼び出すと、受け入れられたソケット上のすべてのイベントコールバック関数が既定で無効になります。 WSK アプリケーションがリッスンソケットで接続指向ソケットイベントコールバック関数のいずれかを有効にした場合、それらのイベントコールバック関数は、そのリッスンソケットで受け入れられるすべての接続指向ソケットで既定で有効になります。受け入れられたソケットのイベントコールバック関数のいずれかを有効にする方法の詳細については、「イベントコールバック関数の有効化と無効化を参照してください。

LocalAddress および RemoteAddress パラメーターが指す SOCKADDR 構造体は、WskAcceptEvent イベントコールバック関数の呼び出しの期間中のみ有効です。 WSK アプリケーションが後でこれらのトランスポートアドレスを必要とする場合は、WskAcceptEvent イベントコールバック関数から戻る前に、これらの構造体の内容を独自の SOCKADDR 構造体にコピーするか、後で受け入れられたソケットで wskGetLocalAddress を呼び出して WskGetRemoteAddress 関数をできます。

WSK サブシステムは、WSK アプリケーションの代わりに、受け入れられた接続のソケットオブジェクト構造 (WSK_SOCKET) にメモリを割り当てます。 WSK サブシステムは、ソケットが閉じられると、このメモリの割り当てを解除します。

WSK サブシステムは、WSK アプリケーションの WskAcceptEvent イベントコールバック関数を IRQL <= DISPATCH_LEVEL で呼び出します。

WSK アプリケーションの WskAcceptEvent イベントコールバック関数は、WSK 完了関数またはイベントコールバック関数のコンテキストで他の WSK 要求の完了を待つ必要はありません。コールバックは他の WSK 要求を開始できますが (DISPATCH_LEVELで時間がかかりすぎないことを前提とします)、IRQL = PASSIVE_LEVEL でコールバックが呼び出された場合でも、その完了を待つ必要はありません。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	wsk.h (Wsk.h を含む)
IRQL	<= DISPATCH_LEVEL

次の方法で共有

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

構文

パラメーター

WSK_FLAG_AT_DISPATCH_LEVEL

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース