PFN_WSK_RELEASE_DATA_INDICATION_LIST función de devolución de llamada (wsk.h)
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 |
|---|---|
|
La lista de búferes se publicó correctamente. |
|
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 |