AppCaptureRegisterMetadataPurged

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

Syntax

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

Parameters

queue   _In_opt_
类型：XTaskQueueHandle 用于处理异步工作的异步队列。如果未指定，将创建默认的异步队列。 context   _In_
类型：void* 要传递给回调函数的信息。通常为调用对象。 callback   _In_
类型：XAppCaptureMetadataPurgedCallback* 在异步工作完成后调用的回调函数。 token   _Out_
类型：XTaskQueueRegistrationToken* 标识事件处理程序的令牌。

Return value

类型：HRESULT 函数结果。

Remarks

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

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

Requirements

头文件： XAppCapture.h 库： xgameruntime.lib 受支持的平台： Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

时间敏感线程

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

AppCaptureRegisterMetadataPurged

AppCaptureRegisterMetadataPurged

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also

​AppCaptureRegisterMetadataPurged

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​Conceptual documentation

​See also

AppCaptureRegisterMetadataPurged

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also