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

# XAppCaptureMetadataRemainingStorageBytesAvailable

> XAppCaptureMetadataRemainingStorageBytesAvailable

# XAppCaptureMetadataRemainingStorageBytesAvailable

返回应用捕获元数据剩余的可用存储空间，以字节为单位。

## 语法

```cpp theme={null}
HRESULT XAppCaptureMetadataRemainingStorageBytesAvailable(  
         uint64_t* value  
)  
```

### 参数

*value*   \_Out\_\
类型：uint64\_t\*

仍可用于存储应用捕获元数据的字节数

### 返回值

类型：HRESULT

函数结果。

## 备注

<Note>此函数不能在时间敏感线程上安全调用。有关详细信息，请参阅 [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

捕获平台会对应用程序可添加的元数据总量施加限制。开发者可以使用此函数查询剩余的存储空间，并据此判断自己是否过度使用了元数据。即使存储空间已满，平台仍会继续接受新的状态和事件，但会执行清理操作以确保存储约束得到维持。建议监控可用的存储空间，以避免触发 [XAppCaptureMetaDataPurgedCallback](/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback)。

## 要求

**头文件：** XAppCapture.h

**库：** xgameruntime.lib

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

## 概念性文档

* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另请参阅

[GameDVR 概览](/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture 成员](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureMetaDataPurgedCallback](/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback)


## Related topics

- [XAppCapture](/zh-CN/reference/system/xappcapture/xappcapture_members.md)
- [面向 GDK 的 Unity C# API 包装器](/zh-CN/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XAppCaptureMetadataPriority](/zh-CN/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)
- [AppCaptureRegisterMetadataPurged](/zh-CN/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged.md)
- [XAppCaptureMetadataStopState](/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)