PFN_WSK_SEND_BACKLOG_EVENT回呼函式 （wsk.h）
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 子系統會呼叫 WSK 應用程式的 WskSendBacklogEvent 事件回呼函式時，理想的傳送待辦專案大小變更。 如需啟用套接字事件回呼函式的詳細資訊，請參閱 啟用和停用事件回呼函式。
連接導向套接字的理想傳送待辦專案大小是需要保持未處理之傳送數據的最佳數量（也就是傳遞至 WSK 子系統但尚未完成），以隨時保留套接字的數據流完整。 WSK 應用程式可以使用這個大小，以累加方式探查和鎖定要根據基礎連線流程控制狀態傳送的數據緩衝區。
WSK 應用程式可以隨時呼叫 WskControlSocket 函式，以取得連線導向套接字目前理想的待辦專案大小。
WSK 子系統會在 IRQL <= DISPATCH_LEVEL 呼叫 WSK 應用程式的 WskSendBacklogEvent 事件回呼函式。
WSK 應用程式的 WskSendBacklogEvent 事件回呼函式不得等候 WSK 完成或事件回呼函式內容中的其他 WSK 要求完成。 回呼可以起始其他 WSK 要求（假設它不會花太多時間在DISPATCH_LEVEL），但即使在 IRQL = PASSIVE_LEVEL 呼叫回呼，也不得等待完成。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
| 目標平臺 | 窗戶 |
| 標頭 | wsk.h （包括 Wsk.h） |
| IRQL | <= DISPATCH_LEVEL |