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

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

WskSendBacklogEvent イベントコールバック関数は、接続指向ソケットの理想的な送信バックログサイズが変更されたときに WSK アプリケーションに通知します。

構文

PFN_WSK_SEND_BACKLOG_EVENT PfnWskSendBacklogEvent;

NTSTATUS PfnWskSendBacklogEvent(
  [in, optional] PVOID SocketContext,
  [in]           SIZE_T IdealBacklogSize
)
{...}

パラメーター

[in, optional] SocketContext

理想的な送信バックログサイズの変更について WSK アプリケーションに通知する、接続指向ソケットのソケットコンテキストへのポインター。 WSK アプリケーションは、次のいずれかの方法で WSK サブシステムへのこのポインターを提供しました。

ソケットを作成するために、WskSocket 関数を呼び出しました。
ソケットを作成するために、WskSocketConnect 関数を呼び出しました。
ソケットを受信接続として受け入れるために、WskAccept 関数を呼び出しました。
その WskAcceptEvent イベントコールバック関数は、ソケットを受信接続として受け入れるために呼び出されました。

[in] IdealBacklogSize

新しい理想的な送信バックログサイズを含む変数。

戻り値

WSK アプリケーションの WskSendBacklogEvent イベントコールバック関数は、常にSTATUS_SUCCESSを返す必要があります。

備考

WSK サブシステムは、イベントコールバック関数が以前に SO_WSK_EVENT_CALLBACK ソケットオプションで有効になっていた場合にのみ、接続指向ソケットの理想的な送信バックログサイズが変更された場合に、WSK アプリケーションの WskSendBacklogEvent イベントコールバック関数を呼び出します。ソケットのイベントコールバック関数の有効化の詳細については、「イベントコールバック関数の有効化と無効化」を参照してください。

接続指向ソケットの理想的な送信バックログサイズは、ソケットのデータストリームを常にいっぱいに保つために、未処理 (つまり、WSK サブシステムに渡されるがまだ完了していない) に保持する必要がある送信データの最適な量です。 WSK アプリケーションでは、このサイズを使用して、基になる接続のフロー制御状態に基づいて送信されるデータのバッファーを段階的にプローブおよびロックできます。

WSK アプリケーションは、WskControlSocket 関数を呼び出すことによって、接続指向ソケットの現在の理想的なバックログサイズをいつでも取得できます。

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

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

必要条件

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

次の方法で共有

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

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース