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

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

  • Статья

Функция обратного вызова событий 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 , переданным в функцию WskRegister .

[in] EventType

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

[in, optional] Information

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

[in] InformationLength

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

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

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

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

Комментарии

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

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

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

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

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

Требования

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

См. также раздел

WSK_CLIENT_DISPATCH

WskRegister