PFN_WSK_CLIENT_EVENT función de devolución de llamada (wsk.h)

La función de devolución de llamada de eventos WskClientEvent notifica a una aplicación WSK sobre eventos que no son específicos de un socket determinado.

Sintaxis

PFN_WSK_CLIENT_EVENT PfnWskClientEvent;

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

Parámetros

[in, optional] ClientContext

Puntero al valor de contexto especificado por el parámetro WskClientNpi pasado a la función WskRegister .

[in] EventType

Evento específico sobre el que se notifica la aplicación WSK. Actualmente no hay ningún evento definido.

[in, optional] Information

Puntero a un búfer que contiene información adicional asociada al evento. Si no hay información adicional asociada al evento, este puntero será NULL.

[in] InformationLength

Longitud de la información adicional contenida en el búfer al que apunta el
Parámetro de información . Si no hay información adicional asociada al evento, este valor será cero.

Valor devuelto

La función de devolución de llamada de eventos WskClientEvent de una aplicación WSK puede devolver uno de los siguientes códigos NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	La notificación de eventos se procesó correctamente.
STATUS_NOT_IMPLEMENTED	No se implementa la compatibilidad con el evento que se pasa en el parámetro Event .

Comentarios

Actualmente, no se define ningún evento para la función de devolución de llamada de eventos WskClientEvent . Por lo tanto, si una aplicación WSK implementa una función de devolución de llamada de eventos WskClientEvent , siempre debe devolver STATUS_NOT_IMPLEMENTED.

La información adicional contenida en el búfer al que apunta el parámetro Information es de solo lectura y solo es válida durante la llamada a la función de devolución de llamada de evento WskClientEvent .

Si una aplicación WSK no implementa una función de devolución de llamada de eventos WskClientEvent , debe establecer el miembro WskClientEvent de la estructura WSK_CLIENT_DISPATCH en NULL antes de llamar a WskRegister.

El subsistema WSK llama a la función de devolución de llamada de eventos WSKClientEvent de una aplicación WSK en IRQL <= DISPATCH_LEVEL.

La función de devolución de llamada de eventos WSKClientEvent de una aplicación WSK no debe esperar a que se completen otras solicitudes WSK en el contexto de las funciones de finalización de WSK o devolución de llamada de eventos. La devolución de llamada puede iniciar otras solicitudes de WSK (suponiendo que no pasa demasiado tiempo en DISPATCH_LEVEL), pero no debe esperar a su finalización incluso cuando se llama a la devolución de llamada en IRQL = PASSIVE_LEVEL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Windows
Encabezado	wsk.h (incluya Wsk.h)
IRQL	<= DISPATCH_LEVEL

Consulte también

WSK_CLIENT_DISPATCH

WskRegister