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 alors qu’aucune mémoire tampon en mode utilisateur disponible n’a été soumise (par exemple via WSARecv). Toute charge utile entrante qui dépasserait cette limite est ignorée, ce qui apparaît pour l’expéditeur comme une perte de paquets nécessitant une nouvelle tentative, avec des conséquences potentielles sur la latence 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 sont empêchées jusqu’à ce que le titre lise les mémoires tampons de réception en file d’attente existantes 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, qui ne limite pas artificiellement les allocations (bien que celles-ci puissent toujours échouer si la mémoire réellement disponible pour la partition du titre est insuffisante). La valeur par défaut sur XBOX est 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 échoue avec le code d’erreur E_NOTIMPL. La récupération de ce paramètre sur PC renvoie 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 alors qu’aucune mémoire tampon de socket n’a encore été soumise. Toute charge utile entrante qui dépasserait cette limite est ignorée, ce qui apparaît pour l’expéditeur comme une perte de paquets nécessitant une nouvelle tentative, avec des conséquences potentielles sur la latence 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 sont empêchées jusqu’à ce que le système lise les mémoires tampons de réception en file d’attente existantes 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, qui ne limite pas artificiellement les allocations (bien que celles-ci puissent toujours échouer si la mémoire réellement disponible pour la partition système est insuffisante). La valeur par défaut sur XBOX est 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 échoue avec le code d’erreur E_NOTIMPL. La récupération de ce paramètre sur PC renvoie 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 alors qu’aucune mémoire tampon de socket n’a encore été soumise. Toute charge utile entrante qui dépasserait cette limite est ignorée, ce qui apparaît pour l’expéditeur comme une perte de paquets nécessitant une nouvelle tentative, avec des conséquences potentielles sur la latence 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 sont empêchées jusqu’à ce que les outils de développement lisent les mémoires tampons de réception en file d’attente existantes 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, qui ne limite pas artificiellement les allocations (bien que celles-ci puissent toujours é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 échoue avec le code d’erreur E_NOTIMPL. La récupération de cette valeur sur PC renvoie 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