SIO_WSK_QUERY_IDEAL_SEND_BACKLOG

L’opération de contrôle d’E/S de 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 (autrement dit, transmises au sous-système WSK, mais pas encore terminées) pour conserver le flux de données du socket en permanence. Une application WSK peut utiliser cette taille pour effectuer une sonde incrémentielle et verrouiller 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	ZÉRO
OutputSize	sizeof(SIZE_T)
OutputBuffer	Pointeur vers une variable SIZE_T typée qui reçoit la taille de backlog d’envoi idéale actuelle
OutputSizeReturned	ZÉRO

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 de backlog d’envoi idéale en activant sa fonction de rappel d’événements WskSendBacklogEvent.

Exigences

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