次の方法で共有

XAppCaptureMetadataAddInt32Event

  • [アーティクル]

Int32 型の値を持つメタデータ イベントをアプリのキャプチャに追加します。

構文

HRESULT XAppCaptureMetadataAddInt32Event(  
         const char* name,  
         int32_t value,  
         XAppCaptureMetadataPriority priority  
)

パラメーター

name _In_z_
型: char*

アプリのキャプチャ タイムラインに追加されるイベントの名前。

value _In_
型: int32_t

タイムラインに追加されるイベントの値。 Int32 でなければなりません。

priority _In_
型: XAppCaptureMetadataPriority

メタデータの優先順位。 ストレージのリミッターを超えた場合に保存するものを決定するために使用されます。 XAppCaptureMetaDataPriority 列挙型のメンバー。

戻り値

型: HRESULT

関数の結果です。

解説

注意

この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」をご覧ください。

このメソッドが呼び出されると、システムはメタデータ イベントをタイムスタンプに関連付けます。 このメタデータは、ライブ ストリーミング中のイベント、およびコンテンツの分類と検索のためにキャプチャされた再生を識別するために使用されます。 時間ウィンドウに適用される整数値を保存するには、XAppCaptureMetaDataStartInt32State を使用します。

注意

メタデータは、Xbox Live にアップロードされたり、.mp4 ファイルやスクリーンショットに保存されたり、配信の間に使用されたりする可能性があるため、メタ データでユーザーの個人情報を記録しないでください。

要件

ヘッダー: XAppCapture.h

ライブラリ: xgameruntime.lib

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

関連項目

ゲーム録画の概要
XAppCapture のメンバー
XAppCaptureMetadataAddDoubleEvent
XAppCaptureMetadataAddStringEvent