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

Artículo
08/08/2023

La función WskRelease libera una lista vinculada de estructuras de WSK_DATA_INDICATION que una aplicación WSK conservaba previamente.

WskRelease se puede declarar de dos maneras diferentes, según el tipo de socket. En este tema se describe WskRelease para sockets orientados a la conexión o escucha. Para los sockets de datagramas, consulte WskRelease (sockets de datagramas).

Sintaxis

PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;

NTSTATUS PfnWskReleaseDataIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATA_INDICATION DataIndication
)
{...}

Parámetros

[in] Socket

Puntero a una estructura de WSK_SOCKET que especifica el objeto de socket para el socket desde el que se recibieron los datos.

[in] DataIndication

Puntero a la lista vinculada de estructuras que se van a liberar. Para este parámetro, la aplicación WSK debe especificar el parámetro DataIndication que se pasó a su WskReceiveEvent o a la función de devolución de llamada de eventos WskReceiveFromEvent .

Valor devuelto

WskRelease devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	La lista de búferes se publicó correctamente.
STATUS_INVALID_PARAMETER	Se especificó un parámetro no válido.

Comentarios

En el caso de los sockets orientados a la conexión o escucha, una aplicación WSK llama a la función WskRelease para liberar una lista vinculada de estructuras de WSK_DATA_INDICATION que anteriormente conservaba devolviendo STATUS_PENDING de su WskReceiveEvent o de su función de devolución de llamada de eventos WskReceiveFromEvent .

Al cerrar un socket, llame a la función WskCloseSocket no libera ninguna lista de estructuras vinculadas conservadas pendientes. Una aplicación WSK debe liberar todas las listas vinculadas retenidas de estructuras antes de que la aplicación llame a la función WskCloseSocket para cerrar el socket.

Requisitos

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