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

Artículo
03/05/2024

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

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

Sintaxis

PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;

NTSTATUS PfnWskReleaseDatagramIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATAGRAM_INDICATION DatagramIndication
)
{...}

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] DatagramIndication

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 DatagramIndication 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 estructuras se publicó correctamente.
STATUS_INVALID_PARAMETER	Se especificó un parámetro no válido.

Comentarios

Una aplicación WSK llama a la función WskRelease para liberar una lista vinculada de estructuras de WSK_DATAGRAM_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