> ## 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>この関数は、時間依存スレッドで呼び出しても安全ではありません。 詳細については、「[Time-sensitive threads](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 本体

## 概念ドキュメント

* [Time-sensitive threads](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](/ja-jp/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged.md)
- [XAppCaptureMetadataPurgedCallback](/ja-jp/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback.md)
- [XAppCaptureMetadataRemainingStorageBytesAvailable](/ja-jp/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable.md)
- [XAppCapture](/ja-jp/reference/system/xappcapture/xappcapture_members.md)
- [XTaskQueueRegistrationToken](/ja-jp/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)