XNetworkingConfigurationSetting
Types de paramètres à utiliser avec XNetworkingSetConfigurationSetting ou XNetworkingQueryConfigurationSetting.Syntaxe
enum class XNetworkingConfigurationSetting : uint32_t
{
MaxTitleTcpQueuedReceiveBufferSize = 0,
MaxSystemTcpQueuedReceiveBufferSize = 1,
MaxToolsTcpQueuedReceiveBufferSize = 2,
}
Constantes
| Constante | Description |
|---|---|
| MaxTitleTcpQueuedReceiveBufferSize | Quantité maximale de mémoire, en octets, que tous les sockets TCP créés par les processus du titre peuvent allouer pour mettre temporairement en file d’attente les charges utiles reçues lorsqu’aucune mémoire tampon en mode utilisateur disponible n’a été soumise (par exemple, au moyen de WSARecv). Toute charge utile entrante qui dépasserait cette limite sera abandonnée, ce qui apparaîtra à l’expéditeur comme une perte de paquets devant faire l’objet d’une nouvelle tentative, avec des répercussions possibles sur le délai et le débit. La valeur du paramètre peut être modifiée à tout moment; si la nouvelle valeur est inférieure à la quantité actuellement allouée, les allocations futures seront empêchées jusqu’à ce que les mémoires tampons de réception en file d’attente existantes soient lues par le titre afin de ramener le total sous la nouvelle valeur. La quantité actuellement allouée peut être déterminée à l’aide de XNetworkingQueryStatistics en spécifiant XNetworkingStatisticsType::TitleTcpQueuedReceivedBufferUsage. La valeur minimale est 0, ce qui empêche toute allocation de mémoire tampon de réception TCP en file d’attente. La valeur maximale est UINT64_MAX, ce qui ne limite pas artificiellement les allocations (bien que celles-ci puissent quand même échouer si la mémoire réellement disponible pour la partition du titre est insuffisante). La valeur par défaut sur XBOX est de 33 554 432 (32 mégaoctets). La valeur par défaut sur PC est 0. Toute tentative de configuration de ce paramètre sur PC échouera avec le code d’erreur E_NOTIMPL. La récupération de ce paramètre sur PC retournera toujours la valeur 0. |
| MaxSystemTcpQueuedReceiveBufferSize | Quantité maximale de mémoire, en octets, que tous les sockets TCP créés par le système peuvent allouer pour mettre temporairement en file d’attente les charges utiles reçues lorsqu’aucune mémoire tampon de socket n’a encore été soumise. Toute charge utile entrante qui dépasserait cette limite sera abandonnée, ce qui apparaîtra à l’expéditeur comme une perte de paquets devant faire l’objet d’une nouvelle tentative, avec des répercussions possibles sur le délai et le débit. La valeur du paramètre peut être modifiée à tout moment; si la nouvelle valeur est inférieure à la quantité actuellement allouée, les allocations futures seront empêchées jusqu’à ce que les mémoires tampons de réception en file d’attente existantes soient lues par le système afin de ramener le total sous la nouvelle valeur. La quantité actuellement allouée peut être déterminée à l’aide de XNetworkingQueryStatistics en spécifiant XNetworkingStatisticsType::SystemTcpQueuedReceivedBufferUsage. La valeur minimale est 0, ce qui empêche toute allocation de mémoire tampon de réception TCP en file d’attente. La valeur maximale est UINT64_MAX, ce qui ne limite pas artificiellement les allocations (bien que celles-ci puissent quand même échouer si la mémoire réellement disponible pour la partition système est insuffisante). La valeur par défaut sur XBOX est de 4 194 304 (4 mégaoctets). La valeur par défaut sur PC est la valeur maximale. Toute tentative de configuration de ce paramètre sur PC échouera avec le code d’erreur E_NOTIMPL. La récupération de ce paramètre sur PC retournera toujours la valeur 0. |
| MaxToolsTcpQueuedReceiveBufferSize | Quantité maximale de mémoire, en octets, que tous les sockets TCP créés par les outils de développement peuvent allouer pour mettre temporairement en file d’attente les charges utiles reçues lorsqu’aucune mémoire tampon de socket n’a encore été soumise. Toute charge utile entrante qui dépasserait cette limite sera abandonnée, ce qui apparaîtra à l’expéditeur comme une perte de paquets devant faire l’objet d’une nouvelle tentative, avec des répercussions possibles sur le délai et le débit. La valeur du paramètre peut être modifiée à tout moment; si la nouvelle valeur est inférieure à la quantité actuellement allouée, les allocations futures seront empêchées jusqu’à ce que les mémoires tampons de réception en file d’attente existantes soient lues par les outils de développement afin de ramener le total sous la nouvelle valeur. La quantité actuellement allouée peut être déterminée à l’aide de XNetworkingQueryStatistics en spécifiant XNetworkingStatisticsType::ToolsTcpQueuedReceivedBufferUsage. La valeur minimale est 0, ce qui empêche toute allocation de mémoire tampon de réception TCP en file d’attente. La valeur maximale est UINT64_MAX, ce qui ne limite pas artificiellement les allocations (bien que celles-ci puissent quand même échouer si la mémoire réellement disponible pour la partition des outils est insuffisante). La valeur par défaut sur XBOX est la valeur maximale. La valeur par défaut sur PC est 0. Toute tentative de configuration de ce paramètre sur PC échouera avec le code d’erreur E_NOTIMPL. La récupération de cette valeur sur PC retournera toujours la valeur 0. |
Configuration requise
En-tête : XNetworking.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
XNetworkingXNetworkingSetConfigurationSetting
XNetworkingQueryConfigurationSetting