Partager via


PFN_WSK_RELEASE_DATA_INDICATION_LIST fonction de rappel (wsk.h)

La fonction WskRelease libère une liste liée de structures WSK_DATA_INDICATION précédemment conservées par une application WSK.

WskRelease peut être déclaré de deux façons différentes, selon le type de socket. Cette rubrique décrit WskRelease pour les sockets orientés connexion ou d’écoute. Pour les sockets datagram, consultez WskRelease (sockets de datagram).

Syntaxe

PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;

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

Paramètres

[in] Socket

Pointeur vers une structure WSK_SOCKET qui spécifie l’objet socket pour le socket à partir duquel les données ont été reçues.

[in] DataIndication

Pointeur vers la liste liée des structures à libérer. Pour ce paramètre, l’application WSK doit spécifier le paramètre DataIndication qui a été passé à sa fonction de rappel d’événement WskReceiveEvent ou fonction de rappel d’événement WskReceiveFromEvent.

Valeur de retour

WskRelease retourne l’un des codes NTSTATUS suivants :

Retourner le code Description
STATUS_SUCCESS
La liste des mémoires tampons a été publiée avec succès.
STATUS_INVALID_PARAMETER
Un paramètre non valide a été spécifié.

Remarques

Pour les sockets orientés connexion ou d’écoute, une application WSK appelle la fonction WskRelease pour libérer une liste liée de structures WSK_DATA_INDICATION qu’elle a précédemment conservées en retournant STATUS_PENDING à partir de son WskReceiveEvent ou de sa fonction de rappel d’événements WskReceiveFromEvent.

La fermeture d’un socket en appelant la fonction WskCloseSocket ne libère aucune liste liée conservée en attente de structures. Une application WSK doit libérer toutes les listes liées conservées de structures avant que l’application appelle la fonction WskCloseSocket pour fermer le socket.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible Universel
d’en-tête wsk.h (include Wsk.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

WSK_DATAGRAM_INDICATION

WSK_DATA_INDICATION

WSK_PROVIDER_CONNECTION_DISPATCH

WSK_PROVIDER_STREAM_DISPATCH

WSK_SOCKET

WskCloseSocket

WskReceiveEvent

WskReceiveFromEvent