> ## 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](/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 개요](/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture 멤버](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureMetaDataPurgedCallback](/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback)


## Related topics

- [XAppCapture](/ko/reference/system/xappcapture/xappcapture_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XAppCaptureMetadataPriority](/ko/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)
- [AppCaptureRegisterMetadataPurged](/ko/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged.md)
- [XAppCaptureMetadataStopState](/ko/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)