функция обратного вызова PFN_WSK_SEND_BACKLOG_EVENT (wsk.h)

Статья
08/08/2023

Функция обратного вызова событий 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

Переменная, содержащая новый идеальный размер невыполненной работы по отправке.

Возвращаемое значение

Функция обратного вызова событий WskSendBacklogEvent приложения WSK всегда должна возвращать STATUS_SUCCESS.

Подсистема WSK вызывает функцию обратного вызова событий WskSendBacklogEvent приложения WSK, когда размер невыполненной работы в идеале изменяется для сокета, ориентированного на подключение, только если функция обратного вызова события ранее была включена с параметром сокета SO_WSK_EVENT_CALLBACK . Дополнительные сведения о включении функций обратного вызова событий сокета см. в разделе Включение и отключение функций обратного вызова событий.

Идеальный размер невыполненной работы по отправке для сокета, ориентированного на подключение, — это оптимальный объем отправляемых данных, которые должны оставаться незавершенными (то есть передаваться в подсистему WSK, но еще не завершены), чтобы поток данных сокета постоянно был заполнен. Приложение WSK может использовать этот размер для добавочной проверки и блокировки буферов данных, которые будут отправляться на основе состояния управления потоком базового подключения.

Приложение WSK может в любой момент получить идеальный размер невыполненной работы для сокета, ориентированного на подключение, путем вызова функции WskControlSocket .

Подсистема WSK вызывает функцию обратного вызова события WskSendBacklogEvent приложения WSK по адресу IRQL <= DISPATCH_LEVEL.

Функция обратного вызова событий WskSendBacklogEvent приложения WSK не должна ожидать завершения других запросов WSK в контексте функций завершения WSK или обратного вызова событий. Обратный вызов может инициировать другие запросы WSK (при условии, что он не тратит слишком много времени на DISPATCH_LEVEL), но не должен ждать их завершения, даже если обратный вызов вызывается по irQL = PASSIVE_LEVEL.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Windows
Header	wsk.h (включая Wsk.h)
IRQL	<= DISPATCH_LEVEL