XAppCaptureMetadataStartInt32State

将具有 Int32 值的元数据状态添加到应用程序捕获。

语法

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

参数

name _In_z_
类型:char*

要添加到应用程序捕获时间线的状态的名称。

value _In_
类型:int32_t

要添加到时间线的状态的值。 必须为 Int32。

priority _In_
类型:XAppCaptureMetadataPriority

元数据的优先级。 用于确定在超过存储限制的情况下保存哪些内容。 XAppCaptureMetaDataPriority 枚举的成员。

返回值

类型:HRESULT

函数结果。

备注

注意

在时间敏感线程上调用此函数是不安全的。 有关详细信息,请参阅时间敏感线程

系统将元数据状态与状态开始时和更改状态值时,或通过调用 XAppCaptureMetaDataStopAllStates 停止状态时之间的时间段相关联 此元数据用于标识实时流期间的事件以及捕获的播放以分类和搜索内容。 要存储适用于瞬时瞬间的整数值,请使用 XAppCaptureMetaDataAddInt32Event

警告

元数据可能上传到 Xbox Live 和/或保存到 .mp4 文件、屏幕截图或在广播期间使用,因此,绝不应使用元数据来记录用户私人信息。

要求

头文件:XAppCapture.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

GameDVR 概述
XAppCapture 成员