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

# AppCaptureRegisterMetadataPurged

> AppCaptureRegisterMetadataPurged

# AppCaptureRegisterMetadataPurged

메타데이터 제거 이벤트에 대한 이벤트 처리기를 등록합니다.

## 구문

```cpp theme={null}
HRESULT XAppCaptureRegisterMetadataPurged(  
         XTaskQueueHandle queue,  
         void* context,  
         XAppCaptureMetadataPurgedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

### 매개 변수

*queue*   \_In\_opt\_\
형식: XTaskQueueHandle

비동기 작업을 처리할 비동기 큐입니다. 할당되지 않으면 기본 비동기 큐가 생성됩니다.

*context*   \_In\_\
형식: void\*

콜백 함수에 전달할 정보입니다. 일반적으로 호출하는 개체입니다.

*callback*   \_In\_\
형식: XAppCaptureMetadataPurgedCallback\*

비동기 작업이 완료된 후 호출될 콜백 함수입니다.

*token*   \_Out\_\
형식: XTaskQueueRegistrationToken\*

이벤트 처리기를 식별하는 토큰입니다.

### 반환 값

형식: HRESULT

함수 결과입니다.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

과거 앱 캡처가 지원되므로 시스템은 활발히 캡처하거나 방송하지 않을 때도 **AppCaptureMetadataWriter**로 기록된 메타데이터를 누적합니다. 예를 들어, 이전 30초의 캡처가 디스크의 비디오 파일에 기록될 때 녹화된 시간 구간과 연결된 메타데이터가 파일에 포함됩니다. 시스템은 누적된 메타데이터를 저장하기 위해 앱별로 할당된 저장소 공간에 제한을 부과합니다. 현재 사용 가능한 저장소 공간은 RemainingStorageBytesAvailable 속성을 확인하여 얻을 수 있습니다.\
할당된 모든 공간이 채워지면 시스템은 메타데이터 항목이 기록되었을 때 지정된 [XAppCaptureMetadataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority) 값과 각 항목의 수명을 사용하여 가장 오래되고 덜 중요한 데이터부터 삭제하기 위해 메타데이터를 제거하기 시작합니다. 이 경우 **MetadataPurged** 이벤트가 발생합니다. 이 이벤트에 대한 응답으로 앱이 기록하는 메타데이터의 양을 줄일 수 있지만 필수는 아닙니다.

## 요구 사항

**헤더:** 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)\
[XAppCaptureUnRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged)


## Related topics

- [XAppCaptureUnRegisterMetadataPurged](/ko/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged.md)
- [XAppCaptureMetadataPurgedCallback](/ko/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback.md)
- [XAppCapture](/ko/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureMetadataRemainingStorageBytesAvailable](/ko/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable.md)
- [XTaskQueueRegistrationToken](/ko/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)