> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingConfigurationSetting

> XNetworkingConfigurationSetting

# XNetworkingConfigurationSetting

用于 [XNetworkingSetConfigurationSetting](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingsetconfigurationsetting.md) 或 [XNetworkingQueryConfigurationSetting](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingqueryconfigurationsetting.md) 的设置类型。

## 语法

```cpp theme={null}
enum class XNetworkingConfigurationSetting  : uint32_t  
{  
    MaxTitleTcpQueuedReceiveBufferSize = 0,  
    MaxSystemTcpQueuedReceiveBufferSize = 1,  
    MaxToolsTcpQueuedReceiveBufferSize = 2,  
}  
```

## 常量

| 常量 | 说明 |
| - | - |
| MaxTitleTcpQueuedReceiveBufferSize | 由游戏进程创建的所有 TCP 套接字可分配用于临时排队已接收有效负载（在尚未提交任何可用用户模式缓冲区时，例如通过 [WSARecv](https://learn.microsoft.com/windows/win32/api/winsock2/nf-winsock2-wsarecv)）的最大内存量（以字节为单位）。任何超过此限制的到达有效负载将被丢弃，对发送方而言表现为必须重试的丢包，可能造成延迟和吞吐量影响。 该值设置可以随时修改；如果新值低于当前已分配数量，则在游戏读取现有排队接收缓冲区使总量降到新值以下之前，将阻止未来分配。可通过使用 [XNetworkingQueryStatistics](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerystatistics.md) 并指定 [XNetworkingStatisticsType](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/enums/xnetworkingstatisticstype.md)::TitleTcpQueuedReceivedBufferUsage 来确定当前分配的数量。 最小值为 0，将阻止任何排队的 TCP 接收缓冲区分配。最大值为 UINT64\_MAX，不会人为地限制分配（尽管如果游戏分区没有足够的实际内存，分配仍可能失败）。XBOX 上的默认值为 33,554,432（32 兆字节）。PC 上的默认值为 0。  尝试在 PC 上配置此参数设置将失败，返回 E\_NOTIMPL 错误代码。在 PC 上检索此设置将始终报告值 0。 |
| MaxSystemTcpQueuedReceiveBufferSize | 由系统创建的所有 TCP 套接字可分配用于临时排队已接收有效负载（在尚未提交任何套接字缓冲区时）的最大内存量（以字节为单位）。任何超过此限制的到达有效负载将被丢弃，对发送方而言表现为必须重试的丢包，可能造成延迟和吞吐量影响。  该值设置可以随时修改；如果新值低于当前已分配数量，则在系统读取现有排队接收缓冲区使总量降到新值以下之前，将阻止未来分配。可通过使用 [XNetworkingQueryStatistics](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerystatistics.md) 并指定 [XNetworkingStatisticsType](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/enums/xnetworkingstatisticstype.md)::SystemTcpQueuedReceivedBufferUsage 来确定当前分配的数量。  最小值为 0，将阻止任何排队的 TCP 接收缓冲区分配。最大值为 UINT64\_MAX，不会人为地限制分配（尽管如果系统分区没有足够的实际内存，分配仍可能失败）。XBOX 上的默认值为 4,194,304（4 兆字节）。PC 上的默认值为最大值。  尝试在 PC 上配置此参数设置将失败，返回 E\_NOTIMPL 错误代码。在 PC 上检索此设置将始终报告值 0。 |
| MaxToolsTcpQueuedReceiveBufferSize | 由开发工具创建的所有 TCP 套接字可分配用于临时排队已接收有效负载（在尚未提交任何套接字缓冲区时）的最大内存量（以字节为单位）。任何超过此限制的到达有效负载将被丢弃，对发送方而言表现为必须重试的丢包，可能造成延迟和吞吐量影响。  该值设置可以随时修改；如果新值低于当前已分配数量，则在开发工具读取现有排队接收缓冲区使总量降到新值以下之前，将阻止未来分配。可通过使用 [XNetworkingQueryStatistics](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerystatistics.md) 并指定 [XNetworkingStatisticsType](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/enums/xnetworkingstatisticstype.md)::ToolsTcpQueuedReceivedBufferUsage 来确定当前分配的数量。  最小值为 0，将阻止任何排队的 TCP 接收缓冲区分配。最大值为 UINT64\_MAX，不会人为地限制分配（尽管如果工具分区没有足够的实际内存，分配仍可能失败）。XBOX 上的默认值为最大值。PC 上的默认值为 0。  尝试在 PC 上配置此参数设置将失败，返回 E\_NOTIMPL 错误代码。在 PC 上检索此值将始终报告值 0。 |

## 要求

**头文件：** XNetworking.h

**支持的平台**：Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[XNetworking](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/xnetworking_members.md)\
[XNetworkingSetConfigurationSetting](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingsetconfigurationsetting.md)\
[XNetworkingQueryConfigurationSetting](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingqueryconfigurationsetting.md)


## Related topics

- [XNetworkingSetConfigurationSetting](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingsetconfigurationsetting.md)
- [XNetworkingQueryConfigurationSetting](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingqueryconfigurationsetting.md)
- [XNetworking（API 内容）](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/xnetworking_members.md)
- [XNetworkingTcpQueuedReceivedBufferUsageStatistics](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/structs/xnetworkingtcpqueuedreceivedbufferusagestatistics.md)
- [首选 UDP 多人游戏端口](https://docs.xbox.com/zh-CN/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)