PFN_WSK_SEND_BACKLOG_EVENT回呼函式 (wsk.h)

發行項
02/27/2024

當連接導向套接字的理想傳送待辦專案大小變更時， 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。

備註

只有在先前使用 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 作業系統中使用。
目標平台	Windows
標頭	wsk.h (包含 Wsk.h)
IRQL	<= DISPATCH_LEVEL