AppCaptureRegisterMetadataPurged
メタデータ パージ イベントのイベント ハンドラーを登録します。構文
パラメーター
queue _In_opt_型: XTaskQueueHandle 非同期作業を処理する非同期キューです。 割り当てられていない場合、既定の非同期キューが作成されます。 context _In_
型: void* コールバック関数に渡される情報です。 通常は呼び出し元のオブジェクトです。 callback _In_
型: XAppCaptureMetadataPurgedCallback* 非同期作業の完了後に呼び出されるコールバック関数です。 token _Out_
型: XTaskQueueRegistrationToken* イベント ハンドラーを識別するトークンです。
戻り値
型: HRESULT 関数の結果です。解説
この関数は、時間依存スレッドで呼び出しても安全ではありません。 詳細については、「Time-sensitive threads」を参照してください。
割り当てられた領域がすべていっぱいになると、システムはメタデータ項目が書き込まれた際に指定された XAppCaptureMetadataPriority 値と、各項目の経過時間を使用して、最も古く重要度の低いデータから順に削除するためにメタデータのパージを開始します。 これが発生すると、MetadataPurged イベントが発生します。 このイベントに応じて、アプリが書き込んでいるメタデータの量を減らすことを選択できますが、必須ではありません。
要件
ヘッダー: XAppCapture.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体概念ドキュメント
関連項目
GameDVR の概要XAppCapture メンバー
XAppCaptureUnRegisterMetadataPurged