> ## 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](/reference/networking/xnetworking/enums/xnetworkingstatisticstype)

用于标识要检索的特定统计信息的枚举值。

*statisticsBuffer*    \_Out\_\
类型：[XNetworkingStatisticsBuffer](/reference/networking/xnetworking/structs/xnetworkingstatisticsbuffer)

指向调用方提供的结构体的指针，请求的统计信息将写入其中。联合体缓冲区中实际被写入的确切子结构字段取决于请求的统计信息类型。

### 返回值

类型：HRESULT

如果成功检索统计信息，则为 S\_OK。如果当前平台不支持检索指定的统计信息类型，则为 E\_NOTIMPL。如果游戏运行时无法识别指定的统计信息类型，则为 E\_INVALIDARG。

## 备注

此函数将指定的网络相关统计信息的快照检索到调用方提供的缓冲区中。请注意，大多数统计信息不能保证在多次调用此函数时报告相同的值。

只有输出缓冲区联合体中特定于统计信息的子结构字段会被写入。调用方输出缓冲区中由联合体整体定义但位于该子结构末尾之外的任何额外内存，均不会被此函数以任何方式修改。

## 要求

**头文件：** XNetworking.h

**库：** xgameruntime.lib

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

## 另请参阅

[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

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