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

# DSTORAGE_STATS

> DSTORAGE_STATS

# DSTORAGE\_STATS

DirectStorage 统计信息。

## Syntax

```cpp theme={null}
struct DSTORAGE_STATS
{
    DSTORAGE_PRIORITY_STATS LowPriorityStats;
    DSTORAGE_PRIORITY_STATS NormalPriorityStats;
    DSTORAGE_PRIORITY_STATS HighPriorityStats;
    DSTORAGE_PRIORITY_STATS RealtimePriorityStats;
    UINT8 CurrentOpenVirtualDiskCount;
    UINT8 MaxOpenVirtualDiskCount;
    UINT32 CumulativeOpenVirtualDiskCount;
    UINT32 PendingStorageRequestCount;
    UINT32 TotalStorageRequestCount;
    UINT32 StorageRetries;
    UINT32 StorageErrors;
    UINT32 PendingDecompressionRequestCount;
    UINT32 TotalDecompressionRequestCount;
    UINT32 DecompressionErrors;
    UINT32 StagingBufferStallCount;
    UINT32 CurrentOpenFileCount;
    UINT32 MaxOpenFileCount;
    UINT32 CumulativeOpenFileCount;
    UINT32 CurrentTitleMemoryUsageBytes;
    UINT32 MaxTitleMemoryUsageBytes;
    UINT32 ErrorCount;
};
```

### Members

*LowPriorityStats*\
类型：[DSTORAGE\_PRIORITY\_STATS](/reference/system/dstorage/structs/dstorage_priority_stats)

低优先级队列的统计信息。

*NormalPriorityStats*\
类型：[DSTORAGE\_PRIORITY\_STATS](/reference/system/dstorage/structs/dstorage_priority_stats)

普通优先级队列的统计信息。

*HighPriorityStats*\
类型：[DSTORAGE\_PRIORITY\_STATS](/reference/system/dstorage/structs/dstorage_priority_stats)

高优先级队列的统计信息。

*RealtimePriorityStats*\
类型：[DSTORAGE\_PRIORITY\_STATS](/reference/system/dstorage/structs/dstorage_priority_stats)

实时优先级队列的统计信息。

*CurrentOpenVirtualDiskCount*\
类型：UINT8

当前打开的虚拟磁盘数量（游戏包、DLC 包、开发者临时存储、PLS）。

*MaxOpenVirtualDiskCount*\
类型：UINT8

同时打开的最高虚拟磁盘数量。

*CumulativeOpenVirtualDiskCount*\
类型：UINT32

累计打开的虚拟磁盘数量。

*PendingStorageRequestCount*\
类型：UINT32

DirectStorage 已向存储设备发送但硬件尚未完成的请求数量。

*TotalStorageRequestCount*\
类型：UINT32

DirectStorage 向存储设备发送的请求总数。

*StorageRetries*\
类型：UINT32

存储设备重试次数。

*StorageErrors*\
类型：UINT32

存储设备错误次数。

*PendingDecompressionRequestCount*\
类型：UINT32

当前挂起的解压缩请求数量。

*TotalDecompressionRequestCount*\
类型：UINT32

解压缩请求总数。

*DecompressionErrors*\
类型：UINT32

解压缩错误次数。

*StagingBufferStallCount*\
类型：UINT32

由暂存缓冲区已满导致的停顿次数。

*CurrentOpenFileCount*\
类型：UINT32

当前打开的文件数量。

*MaxOpenFileCount*\
类型：UINT32

同时打开的最高文件数量。

*CumulativeOpenFileCount*\
类型：UINT32

累计打开的文件数量。

*CurrentTitleMemoryUsageBytes*\
类型：UINT32

当前 DirectStorage 内存占用（包括暂存缓冲区等）。

*MaxTitleMemoryUsageBytes*\
类型：UINT32

DirectStorage 内存占用的最高值（包括暂存缓冲区等）。

*ErrorCount*\
类型：UINT32

错误总数。
每次请求因任何原因失败时，错误计数都会递增。示例错误包括：从无效偏移量读取数据、存储设备错误、解压缩错误、无效的请求参数等。

## Remarks

此结构由 [IDStorageFactoryX1::GetStats](/reference/system/dstorage/interfaces/IDStorageFactoryX1/methods/idstoragefactoryx1_getstats) 方法使用。

## Requirements

**头文件：** dstorage\_xs.h

**受支持的平台：** XBOX Series 主机

## See also

[DStorage](/reference/system/dstorage/dstorage_members)


## Related topics

- [DSTORAGE_PRIORITY_STATS](/zh-CN/reference/system/dstorage/structs/dstorage_priority_stats.md)
- [DStorage](/zh-CN/reference/system/dstorage/dstorage_members.md)
- [IDStorageFactoryX1::GetStats](/zh-CN/reference/system/dstorage/interfaces/IDStorageFactoryX1/methods/idstoragefactoryx1_getstats.md)
- [DSTORAGE_PRIORITY](/zh-CN/reference/system/dstorage/enums/dstorage_priority.md)
- [DSTORAGE_REQUEST](/zh-CN/reference/system/dstorage/structs/dstorage_request.md)
