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

# XAppCaptureMetadataPriority

> XAppCaptureMetadataPriority

# XAppCaptureMetadataPriority

**AppCaptureMetadataWriter** を使用して保存されたアプリ キャプチャ メタデータ項目の相対的な重要度を指定します。 蓄積されたメタデータに割り当てられたストレージ領域が少なくなると、システムはメタデータ項目の優先度と経過時間を使用して、ストレージ領域を解放するためにメタデータをパージする順序を決定します。

## 構文

```cpp theme={null}
enum class XAppCaptureMetadataPriority  : uint8_t  
{  
    Informational = 0,  
    Important,  
}  
```

## 定数

| 定数            | 説明                                        |
| ------------- | ----------------------------------------- |
| Informational | メタデータは情報用であり、ストレージ不足の場合に最初に削除される可能性があります。 |
| Important     | メタデータは重要であり、ストレージ不足の場合、可能な限り削除から保護されます。   |

## 解説

Important 優先度は、メタデータが XBOX Live サービスにアップロードされることを意味します。 メタデータは、ユーザーがクリップを検索したりブロードキャストに注釈を付けたりするのに役立てるなど、さまざまな用途で使用されます。 Important と Informational のどちらのメタデータも、生成される .mp4 ファイルに埋め込まれるため、メタデータにはユーザーのプライベート情報を含めないようにしてください。

この列挙型は、次の関数で設定されたメタデータに優先度の値を与えるために使用されます。

* [XAppCaptureMetaDataAddDoubleEvent](/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent)
* [XAppCaptureMetaDataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadataaddint32event)
* [XAppCaptureMetaDataAddStringEvent](/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent)
* [XAppCaptureMetaDataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate)
* [XAppCaptureMetaDataStartInt32State](/reference/system/xappcapture/functions/xappcapturemetadatastartint32state)
* [XAppCaptureMetadataStartStringState](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate)

パージが必要になった際に削除するデータを決定する際、この優先度が考慮されます。 キャプチャ プラットフォームは、アプリケーションが追加できるメタデータの合計量に制限を設けています。この制限に達すると、新しいイベントは引き続き記録されますが、データ制約内に収めるために他のイベントは削除されます。 この削除は、一部のメタデータに付与された優先度レベルに基づいて行われます。 開発者は、[XAppCaptureMetaDataRemainingStorageBytesAvailable](/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable) を呼び出すことで、残りのデータ量を確認できます。

## 要件

**ヘッダー:** XAppCapture.h

**サポートされているプラットフォーム:** Windows、XBOX One ファミリー本体、XBOX Series 本体

## 関連項目

[GameDVR の概要](/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture メンバー](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureMetaDataAddDoubleEvent](/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent)\
[XAppCaptureMetaDataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadataaddint32event)\
[XAppCaptureMetaDataAddStringEvent](/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent)\
[XAppCaptureMetaDataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate)\
[XAppCaptureMetaDataStartInt32State](/reference/system/xappcapture/functions/xappcapturemetadatastartint32state)\
[XAppCaptureMetadataStartStringState](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate)\
[XAppCaptureMetaDataRemainingStorageBytesAvailable](/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable)


## Related topics

- [AppCaptureMetadataStartStringState](/ja-jp/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)
- [XAppCaptureMetadataStartDoubleState](/ja-jp/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
- [XAppCaptureMetadataAddDoubleEvent](/ja-jp/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
- [XAppCaptureMetadataAddInt32Event](/ja-jp/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
- [XAppCaptureMetadataStartInt32State](/ja-jp/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)
