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

Статья
02/07/2025

Функция обратного вызова событий WskClientEvent уведомляет приложение WSK о событиях, которые не относятся к конкретному сокету.

Синтаксис

PFN_WSK_CLIENT_EVENT PfnWskClientEvent;

NTSTATUS PfnWskClientEvent(
  [in, optional] PVOID ClientContext,
  [in]           ULONG EventType,
  [in, optional] PVOID Information,
  [in]           SIZE_T InformationLength
)
{...}

Параметры

[in, optional] ClientContext

Указатель на значение контекста, указанное параметром WskClientNpi WskClientNpi, переданным в функцию WskRegister.

[in] EventType

Конкретное событие, о котором уведомляется приложение WSK. В настоящее время нет определенных событий.

[in, optional] Information

Указатель на буфер, содержащий дополнительные сведения, связанные с событием. Если с событием нет дополнительных сведений, этот указатель будет NULL.

[in] InformationLength

Длина дополнительных сведений, содержащихся в буфере, на который указывает
параметр Information. Если с событием нет дополнительных сведений, это значение будет равно нулю.

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

Функция обратного вызова событий WSK приложения WSK WskClientEvent может вернуть один из следующих кодов NTSTATUS:

Возвращаемый код	Описание
STATUS_SUCCESS	Уведомление о событии успешно обработано.
STATUS_NOT_IMPLEMENTED	Поддержка события, передаваемого в параметре события, не реализована.

Замечания

В настоящее время для функции обратного вызова событий WskClientE vent не определены события WskClientEvent. Таким образом, если приложение WSK реализует функцию обратного вызова событий WskClientEvent WskClientEvent, она всегда должна возвращать STATUS_NOT_IMPLEMENTED.

Дополнительные сведения, содержащиеся в буфере, на который указывает параметр Information, доступны только для чтения, и допустимы только в течение времени вызова функции обратного вызова WskClientEvent события.

Если приложение WSK не реализует функцию обратного вызова событий WskClientEvent WskClientEvent, перед вызовом WskRegister необходимо задать WSK_CLIENT_DISPATCHэлемент WskClientEvent.

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

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

Требования

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

См. также

WSK_CLIENT_DISPATCH

WskRegister

Поделиться через