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 |
|---|---|
|
La liste des structures a été publiée avec succès. |
|
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 |