функция обратного вызова 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 приложения WSK WskSendBacklogEvent всегда должна возвращать STATUS_SUCCESS.
Замечания
Подсистема WSK вызывает приложения WSK WskSendBacklogEvent функцию обратного вызова событий, если идеальный размер невыполненной отправки для сокета, ориентированного на подключение, изменяется только в том случае, если функция обратного вызова события ранее была включена с параметром сокета SO_WSK_EVENT_CALLBACK. Дополнительные сведения о включении функций обратного вызова событий сокета см. в разделе Включение и отключение функций обратного вызова событий.
Идеальный размер невыполненной отправки для сокета, ориентированного на подключение, — это оптимальный объем данных отправки, которые должны храниться невыполненными (т. е. переданы подсистеме WSK, но еще не завершены) для обеспечения полного полного потока данных сокета. Приложение WSK может использовать этот размер для добавочной проверки и блокировки буферов данных, отправляемых на основе состояния управления потоком базового подключения.
Приложение WSK может получить текущий идеальный размер невыполненной работы для сокета, ориентированного на подключение, в любое время путем вызова функции WskControlSocket.
Подсистема WSK вызывает функцию обратного вызова событий WSK приложения WSK WskSendBacklogEvent в IRQL <= DISPATCH_LEVEL.
Функция обратного вызова событий WSK приложения WSK WskSendBacklogEvent не должна ожидать завершения других запросов WSK в контексте выполнения WSK или функций обратного вызова событий. Обратный вызов может инициировать другие запросы WSK (если он не тратит слишком много времени на DISPATCH_LEVEL), но он не должен ждать завершения даже при вызове обратного вызова в IRQL = PASSIVE_LEVEL.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| целевая платформа | Виндоус |
| заголовка | wsk.h (include Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |