AppCaptureMetadataStartStringState
将具有 string 值的元数据状态添加到应用程序捕获。
语法
HRESULT XAppCaptureMetadataStartStringState(
const char* name,
const char* value,
XAppCaptureMetadataPriority priority
)
参数
name _In_z_
类型：char*
要添加到应用程序捕获时间线的状态的名称。
value _In_z_
类型：char*
要添加到时间线的状态的值。 必须为字符串。
priority _In_
类型：XAppCaptureMetadataPriority
元数据的优先级。 用于确定在超过存储限制的情况下保存哪些内容。 XAppCaptureMetaDataPriority 枚举的成员。
返回值
类型：HRESULT
函数结果。
备注
注意
在时间敏感线程上调用此函数是不安全的。 有关详细信息，请参阅时间敏感线程。
系统将元数据状态与状态开始时和更改状态值时，或通过调用 XAppCaptureMetaDataStopAllStates 停止状态时之间的时间段相关联 此元数据用于标识实时流期间的事件以及捕获的播放以分类和搜索内容。 要存储适用于瞬时瞬间的 string 值，请使用 XAppCaptureMetadataAddStringEvent。
警告
元数据可能上传到 Xbox Live 和/或保存到 .mp4 文件、屏幕截图或在广播期间使用，因此，绝不应使用元数据来记录用户私人信息。
要求
头文件：XAppCapture.h
库：xgameruntime.lib
支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机