énumération WS_TRANSFER_MODE (webservices.h)

  • Article

Indique si les messages envoyés ou reçus sont diffusés en continu ou mis en mémoire tampon.

Syntax

typedef enum {
  WS_STREAMED_INPUT_TRANSFER_MODE = 0x1,
  WS_STREAMED_OUTPUT_TRANSFER_MODE = 0x2,
  WS_BUFFERED_TRANSFER_MODE = 0x0,
  WS_STREAMED_TRANSFER_MODE
} WS_TRANSFER_MODE;

Constantes

 
WS_STREAMED_INPUT_TRANSFER_MODE
Valeur : 0x1
La définition de cet indicateur signifie que les messages sont remis en blocs. Début du message
(l’ouverture de la balise, des en-têtes et de la balise de corps d’ouverture) est retournée à l’application
lorsque WsReadMessageStart se termine. Il appartient à l’application d’appeler
WsFillBody avant de lire chaque segment du corps du message. La fin de
le message (balises de corps et d’enveloppe fermants) est lu lorsque WsReadMessageEnd est appelé.


Ne pas définir cet indicateur signifie que le message entier est lu et mis en mémoire tampon
en mémoire avant que WsReadMessageStart n’indique l’achèvement.
WS_STREAMED_OUTPUT_TRANSFER_MODE
Valeur : 0x2
La définition de cet indicateur signifie que les messages sont transmis en blocs. Début du message (ouverture
la balise d’enveloppe, les en-têtes et la balise de corps d’ouverture) sont transmis lorsque WsWriteMessageStart est appelé. Il appartient à l’application d’appeler WsFlushBody après avoir écrit chaque bloc
du corps du message pour que le bloc soit transmis.
Toutes les données de corps restantes sont transmises lorsque WsWriteMessageEnd est appelé, ainsi que
la fin du message (corps fermant et balises d’enveloppe).


Ne pas définir cet indicateur signifie que l’intégralité du message est mise en mémoire tampon dans
mémoire et sont transmis uniquement une fois que WsWriteMessageEnd est appelé.
WS_BUFFERED_TRANSFER_MODE
Valeur : 0x0
Les messages écrits ou lus sont mis en mémoire tampon.


Cela revient à spécifier ni l’un ni l’autre
WS_STREAMED_INPUT_TRANSFER_MODE ni
WS_STREAMED_OUTPUT_TRANSFER_MODE.
WS_STREAMED_TRANSFER_MODE
Les messages écrits ou lus sont diffusés en continu.


Cela revient à spécifier les deux
WS_STREAMED_INPUT_TRANSFER_MODE et
WS_STREAMED_OUTPUT_TRANSFER_MODE.

Remarques

Cette valeur est spécifiée pour un canal à l’aide de la propriété de canal WS_CHANNEL_PROPERTY_TRANSFER_MODE .

Le modèle de programmation de streaming peut être utilisé quel que soit le mode de transfert utilisé. Dans le cas où la diffusion en continu n’est pas utilisée, les appels aux appels à WsFillBody et WsFlushBody sont des NOPs.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête webservices.h