Partager via


PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST fonction de rappel (wsk.h)

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

Voir aussi

WSK_DATAGRAM_INDICATION

WSK_DATA_INDICATION

WSK_PROVIDER_DATAGRAM_DISPATCH

WSK_SOCKET

WskCloseSocket

WskReceiveEvent

WskReceiveFromEvent