> ## 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>在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

擷取平台會對應用程式可新增的中繼資料總量施加限制。開發人員可以使用此函式查詢剩餘的儲存空間量，並據此判斷是否過度使用中繼資料。即使儲存空間已滿，平台仍會繼續接受新的狀態和事件，但會執行清除作業，以確保維持儲存空間限制。建議您監視可用的儲存空間，以避免觸發 [XAppCaptureMetaDataPurgedCallback](/zh-TW/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback)。

## 需求

**標頭：** XAppCapture.h

**程式庫：** xgameruntime.lib

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

## 概念文件

* [時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

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


## Related topics

- [XAppCaptureMetadataRemainingStorageBytesAvailable](/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable.md)
- [XAppCapture](/reference/system/xappcapture/xappcapture_members.md)