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 se NULL.
[in] InformationLength
Longitud de la información adicional contenida en el búfer al que apunta el
parámetro Information. Si no hay información adicional asociada al evento, este valor será cero.
Valor devuelto
Una aplicación WSK WskClientEvent función de devolución de llamada de eventos puede devolver uno de los siguientes códigos NTSTATUS:
| Código devuelto | Descripción |
|---|---|
|
La notificación de eventos se procesó correctamente. |
|
No se implementa la compatibilidad con el evento que se pasa en el parámetro Event. |
Observaciones
Actualmente, no se define ningún evento para la función de devolución de llamada de eventos WskClientEvent de. Por lo tanto, si una aplicación WSK implementa un WskClientEvent función de devolución de llamada de eventos, 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 de.
Si una aplicación WSK no implementa un función de devolución de llamada de evento WskClientEvent, debe establecer el miembro WskClientEvent de la estructura de WSK_CLIENT_DISPATCH para 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.
Las WskClientEvent de una aplicación WSK función de devolución de llamada de eventos no deben 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Windows |
| encabezado de | wsk.h (incluya Wsk.h) |
| irQL | <= DISPATCH_LEVEL |