PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST fonction de rappel (wsk.h)

Article
03/01/2024

La fonction WskRelease publie une liste liée de structures WSK_DATAGRAM_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 de datagramme. Pour les sockets orientés connexion ou d’écoute, consultez WskRelease (sockets orientés connexion ou à l’écoute).

Syntaxe

PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;

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

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

Pointeur vers la liste liée des structures à libérer. Pour ce paramètre, l’application WSK doit spécifier le paramètre DatagramIndication 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 structures a été publiée avec succès.
STATUS_INVALID_PARAMETER	Un paramètre non valide a été spécifié.

Remarques

Une application WSK appelle la fonction WskRelease pour libérer une liste liée de structures WSK_DATAGRAM_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