> ## 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.

# XNetworkingQueryStatistics

> XNetworkingQueryStatistics

# XNetworkingQueryStatistics

將指定的網路統計資料擷取到呼叫端提供的緩衝區中。

## 語法

```cpp theme={null}
HRESULT XNetworkingQueryStatistics(  
         XNetworkingStatisticsType statisticsType,  
         XNetworkingStatisticsBuffer* statisticsBuffer
)  
```

### 參數

*statisticsType*   \_In\_\
類型：[XNetworkingStatisticsType](/zh-TW/reference/networking/xnetworking/enums/xnetworkingstatisticstype)

識別要擷取之特定統計資料的列舉值。

*statisticsBuffer*    \_Out\_\
類型：[XNetworkingStatisticsBuffer](/zh-TW/reference/networking/xnetworking/structs/xnetworkingstatisticsbuffer)

呼叫端提供之結構的指標，要求的統計資料將寫入其中。在等位緩衝區中實際寫入的子結構欄位取決於所要求的統計資料類型。

### 傳回值

類型：HRESULT

如果成功擷取統計資料，則為 S\_OK。如果目前平台不支援擷取指定的統計資料類型，則為 E\_NOTIMPL。如果 Gaming Runtime 無法辨識指定的統計資料類型，則為 E\_INVALIDARG。

## 備註

此函式會將指定網路相關統計資料的快照擷取到呼叫端提供的緩衝區中。請注意，大部分的統計資料不保證在多次呼叫此函式時會回報相同的值。

只會寫入輸出緩衝區等位中統計資料專屬的子結構欄位。呼叫端輸出緩衝區中由整個等位所定義、但位於子結構結尾之後的任何其他記憶體，都不會被此函式以任何方式修改。

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

[XNetworking](/zh-TW/reference/networking/xnetworking/xnetworking_members)


## Related topics

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