AppCaptureRegisterMetadataPurged

注册元数据清除事件的事件处理程序。

语法

HRESULT XAppCaptureRegisterMetadataPurged(  
         XTaskQueueHandle queue,  
         void* context,  
         XAppCaptureMetadataPurgedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  

参数

queue _In_opt_
类型：XTaskQueueHandle

处理异步工作的异步队列。 如果未分配，将创建默认异步队列。

context _In_
类型：void*

要传递到回调函数的信息。 通常为调用对象。

callback _In_
类型：XAppCaptureMetadataPurgedCallback*

完成异步工作要调用的回调函数。

token _Out_
类型：XTaskQueueRegistrationToken*

标识事件处理程序的令牌。

返回值

类型：HRESULT

函数结果。

备注

注意

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

由于支持历史应用捕获，因此系统会累积使用 AppCaptureMetadataWriter 写入的元数据，即使没有主动捕获或广播也是如此。 例如，当将前 30 秒的捕获写入磁盘上的视频文件时，与录制时间窗口相关联的元数据包含在此文件中。 系统对按每个应用分配的用于存储累积元数据的存储空间施加限制。 您可以通过选中 RemainingStorageBytesAvailable 属性来获取当前可用的存储空间。
当所有分配的空间都已填满后，系统将开始使用写入元数据项时指定的 XAppCaptureMetadataPriority 值以及每个项的存在时间清除元数据，以便首先删除最旧、最不重要的数据。 当发生这种情况时，将引发 MetadataPurged 事件。 为响应此事件，您可以选择减少应用写入的元数据量，但这不是必需的。

要求

头文件：XAppCapture.h

库：xgameruntime.lib

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

另请参阅

GameDVR 概述
XAppCapture 成员
XAppCaptureUnRegisterMetadataPurged