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

Returns the remaining storage available for app capture metadata. Measured in bytes.

## Syntax

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

### Parameters

*value*   \_Out\_\
Type: uint64\_t\*

The number of bytes still available to store app capture metadata

### Return value

Type: HRESULT

Function result.

## Remarks

<Note>This function isn't safe to call on a time-sensitive thread. For more information, see [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

The Capture Platform will impose a limit on the total Metadata that the application can add. The developer can query the amount of storage remaining with this function and use this to determine if he is being over zealous in his use of the metadata. The platform will continue to accept new states and events even after the storage is full, but will perform cleanup operations to ensure the storage constraints are maintained. It is recommended that you monitor the storage available to avoid triggering the [XAppCaptureMetaDataPurgedCallback](/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback).

## Requirements

**Header:** XAppCapture.h

**Library:** xgameruntime.lib

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## Conceptual documentation

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

## See also

[GameDVR Overview](/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture Members](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureMetaDataPurgedCallback](/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback)


## Related topics

- [XAppCapture](/reference/system/xappcapture/xappcapture_members.md)
- [Unity C# API wrappers for the GDK](/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XAppCaptureMetadataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)
- [AppCaptureRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged.md)
- [AppCaptureMetadataStartStringState](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)
