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

Artículo
08/08/2023

La función de devolución de llamada de eventos WskSendBacklogEvent notifica a una aplicación WSK cuando el tamaño ideal del trabajo pendiente de envío cambia para un socket orientado a la conexión.

Sintaxis

PFN_WSK_SEND_BACKLOG_EVENT PfnWskSendBacklogEvent;

NTSTATUS PfnWskSendBacklogEvent(
  [in, optional] PVOID SocketContext,
  [in]           SIZE_T IdealBacklogSize
)
{...}

Parámetros

[in, optional] SocketContext

Puntero al contexto de socket para el socket orientado a la conexión que notifica a la aplicación WSK un cambio en su tamaño ideal de trabajo pendiente de envío. La aplicación WSK proporcionó este puntero al subsistema WSK de una de las maneras siguientes:

Llamó a la función WskSocket para crear el socket.
Llamó a la función WskSocketConnect para crear el socket.
Llamó a la función WskAccept para aceptar el socket como una conexión entrante.
Se llamó a su función de devolución de llamada de eventos WskAcceptEvent para aceptar el socket como una conexión entrante.

[in] IdealBacklogSize

Variable que contiene el nuevo tamaño ideal de trabajo pendiente de envío.

Valor devuelto

La función de devolución de llamada de eventos WSKSendBacklogEvent de una aplicación WSK siempre debe devolver STATUS_SUCCESS.

Comentarios

El subsistema WSK llama a la función de devolución de llamada de eventos WSKSendBacklogEvent de una aplicación WSK cuando el tamaño ideal del trabajo pendiente de envío cambia para un socket orientado a la conexión solo si la función de devolución de llamada de eventos se habilitó anteriormente con la opción de socket SO_WSK_EVENT_CALLBACK . Para obtener más información sobre cómo habilitar las funciones de devolución de llamada de eventos de un socket, consulte Habilitación y deshabilitación de funciones de devolución de llamada de eventos.

El tamaño ideal del trabajo pendiente de envío para un socket orientado a la conexión es la cantidad óptima de datos de envío que deben mantenerse pendientes (es decir, pasados al subsistema WSK pero aún no completados) para mantener el flujo de datos del socket lleno en todo momento. Una aplicación WSK puede usar este tamaño para sondear y bloquear incrementalmente los búferes de datos que se enviarán en función del estado de control de flujo de la conexión subyacente.

Una aplicación WSK puede obtener el tamaño de trabajo pendiente ideal actual para un socket orientado a la conexión en cualquier momento llamando a la función WskControlSocket .

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

La función de devolución de llamada de eventos WSKSendBacklogEvent de una aplicación WSK no debe esperar a que se completen otras solicitudes de WSK en el contexto de las funciones de finalización o devolución de llamada de eventos de WSK. 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