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

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

WskRelease se pueden declarar de dos maneras diferentes, según el tipo de socket. En este tema se describe WskRelease para sockets de datagramas. Para 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 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 WskReceiveFromEvent función de devolución de llamada de eventos.

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.

Observaciones

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 su WskReceiveFromEvent función de devolución de llamada de eventos.

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

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 Universal
encabezado de wsk.h (incluya Wsk.h)
irQL <= DISPATCH_LEVEL

Consulte también

WSK_DATAGRAM_INDICATION

WSK_DATA_INDICATION

WSK_PROVIDER_DATAGRAM_DISPATCH

WSK_SOCKET

WskCloseSocket

WskReceiveEvent de

WskReceiveFromEvent