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

# XNetworkingTcpQueuedReceivedBufferUsageStatistics

> XNetworkingTcpQueuedReceivedBufferUsageStatistics

# XNetworkingTcpQueuedReceivedBufferUsageStatistics

使用 [XNetworkingQueryStatistics](/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerystatistics) 查詢網路統計資料，並指定 TitleTcpQueuedReceivedBufferUsage、SystemTcpQueuedReceivedBufferUsage 或 ToolsTcpQueuedReceivedBufferUsage [XNetworkingStatisticsType](/zh-TW/reference/networking/xnetworking/enums/xnetworkingstatisticstype) 值時所傳回的輸出結構。

## 語法

```cpp theme={null}
typedef struct XNetworkingTcpQueuedReceivedBufferUsageStatistics {  
    uint64_t numBytesCurrentlyQueued;  
    uint64_t peakNumBytesEverQueued;  
    uint64_t totalNumBytesQueued;  
    uint64_t numBytesDroppedForExceedingConfiguredMax;  
    uint64_t numBytesDroppedDueToAnyFailure;  
} XNetworkingTcpQueuedReceivedBufferUsageStatistics  
```

### 成員

*numBytesCurrentlyQueued*\
類型：uint64\_t

目前為保存尚未從對應 TCP 通訊端讀取之已接收承載而配置的所有核心模式緩衝區大小 (以位元組為單位)。遊戲可以在其 TCP 通訊端上呼叫 [WSARecv](https://learn.microsoft.com/windows/win32/api/winsock2/nf-winsock2-wsarecv) 或類似函式來取用現有配置，藉此縮減佇列大小；也可以事先確保已提交足夠的接收作業 (及其緩衝區)，以避免發生配置。

*peakNumBytesEverQueued*\
類型：uint64\_t

曾經在同一時間為保存尚未從對應 TCP 通訊端讀取之已接收承載而配置的所有核心模式緩衝區最大大小 (以位元組為單位)。

*totalNumBytesQueued*\
類型：uint64\_t

曾經為保存尚未從對應 TCP 通訊端讀取之已接收承載而配置的所有核心模式緩衝區中的位元組總數。

*numBytesDroppedForExceedingConfiguredMax*\
類型：uint64\_t

已抵達但遭到捨棄的 TCP 承載位元組數，原因是這些位元組若與已配置的位元組數 (*numBytesCurrentlyQueued*) 合計，將會超過記憶體分割區允許的最大值 (請參閱 [XNetworkingConfigurationSetting](/zh-TW/reference/networking/xnetworking/enums/xnetworkingconfigurationsetting)::MaxTitleTcpQueuedReceiveBufferSize、[XNetworkingConfigurationSetting](/zh-TW/reference/networking/xnetworking/enums/xnetworkingconfigurationsetting)::MaxSystemTcpQueuedReceiveBufferSize 或 [XNetworkingConfigurationSetting](/zh-TW/reference/networking/xnetworking/enums/xnetworkingconfigurationsetting)::MaxToolsTcpQueuedReceiveBufferSize)。

*numBytesDroppedDueToAnyFailure*\
類型：uint64\_t

已抵達但因任何原因導致佇列接收緩衝區配置失敗而遭到捨棄的 TCP 承載位元組數 (包括 *numBytesDroppedForExceedingConfiguredMax*，以及低於最大值但當時記憶體分割區中實際可用記憶體不足的配置嘗試)。

## 需求

**標頭：** XNetworking.h

**支援的平台**：Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XNetworking](/zh-TW/reference/networking/xnetworking/xnetworking_members)\
[XNetworkingQueryStatistics](/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerystatistics)\
[XNetworkingStatisticsBuffer](/zh-TW/reference/networking/xnetworking/structs/xnetworkingstatisticsbuffer)


## Related topics

- [XNetworkingTcpQueuedReceivedBufferUsageStatistics](/reference/networking/xnetworking/structs/xnetworkingtcpqueuedreceivedbufferusagestatistics.md)
- [XNetworkingStatisticsBuffer](/reference/networking/xnetworking/structs/xnetworkingstatisticsbuffer.md)
- [XNetworkingStatisticsType](/reference/networking/xnetworking/enums/xnetworkingstatisticstype.md)
- [XNetworking](/reference/networking/xnetworking/xnetworking_members.md)