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 事件。為回應此事件，您可以選擇減少應用程式寫入的中繼資料量，但這並非必要。

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

AppCaptureRegisterMetadataPurged

語法

參數

傳回值

備註

需求

概念文件

另請參閱

​AppCaptureRegisterMetadataPurged

​語法

​參數

​傳回值

​備註

​需求

​概念文件

​另請參閱

AppCaptureRegisterMetadataPurged

語法

參數

傳回值

備註

需求

概念文件

另請參閱