> ## 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](/zh-TW/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 概觀](/zh-TW/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture 成員](/zh-TW/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureUnRegisterMetadataPurged](/zh-TW/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged)


## Related topics

- [AppCaptureRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged.md)
- [XAppCaptureUnRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged.md)