SIO_WSK_QUERY_IDEAL_SEND_BACKLOG

L’opération de contrôle E/S du socket SIO_WSK_QUERY_IDEAL_SEND_BACKLOG permet à une application WSK d’interroger la taille de backlog d’envoi idéale pour un socket orienté connexion. Cette opération de contrôle d’E/S de socket s’applique uniquement aux sockets orientés connexion.

La taille de backlog d’envoi idéale pour un socket orienté connexion est la quantité optimale de données d’envoi qui doivent être conservées en attente (c’est-à-dire passées au sous-système WSK, mais pas encore terminées) pour maintenir le flux de données du socket complet à tout moment. Une application WSK peut utiliser cette taille pour sonder et verrouiller de manière incrémentielle les mémoires tampons des données à envoyer en fonction de l’état de contrôle de flux de la connexion sous-jacente.

Si une application WSK utilise cette opération de contrôle d’E/S de socket pour interroger la taille de backlog d’envoi idéale, elle doit le faire une fois que le socket orienté connexion a été connecté à une adresse de transport distante.

Pour interroger la taille de backlog d’envoi idéale pour un socket orienté connexion, une application WSK appelle la fonction WskControlSocket avec les paramètres suivants.

Paramètre	Valeur
RequestType	WskIoctl
ControlCode	SIO_WSK_QUERY_IDEAL_SEND_BACKLOG
Niveau	0
InputSize	0
InputBuffer	NULL
OutputSize	sizeof(SIZE_T)
OutputBuffer	Pointeur vers une variable de type SIZE_T qui reçoit la taille de backlog d’envoi idéale actuelle
OutputSizeReturned	NULL

Une application WSK doit spécifier un pointeur vers un IRP lors de l’appel de la fonction WskControlSocket pour interroger la taille de backlog d’envoi idéale pour un socket orienté connexion.

Un socket orienté connexion peut être averti des modifications apportées à la taille idéale du backlog d’envoi en activant sa fonction de rappel d’événement WskSendBacklogEvent .

Spécifications

Version	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête	Wsk.h (inclure Wsk.h)