PFN_WSK_RELEASE_DATA_INDICATION_LIST fonction de rappel (wsk.h)

Article
02/27/2024

La fonction WskRelease publie 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 de datagramme, consultez WskRelease (sockets de datagrammes).

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 WskReceiveFromEvent .

Valeur retournée

WskRelease retourne l’un des codes NTSTATUS suivants :

Code de retour	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 à l’é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 sa fonction de rappel d’événement WskReceiveEvent ou WskReceiveFromEvent .

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Universal
En-tête	wsk.h (inclure Wsk.h)
IRQL	<= DISPATCH_LEVEL