Skip to main content

​
AppCaptureRegisterMetadataPurged

Registra un controlador de eventos para los eventos de purga de metadatos.

​
Sintaxis

​
Parámetros

queue   _In_opt_
Tipo: XTaskQueueHandle Cola asincrónica para controlar el trabajo asincrónico. Si no se asigna, se creará una cola asincrónica predeterminada. context   _In_
Tipo: void* Información que se pasa a la función de devolución de llamada. Normalmente, el objeto que realiza la llamada. callback   _In_
Tipo: XAppCaptureMetadataPurgedCallback* Función de devolución de llamada a la que se llama una vez finalizado el trabajo asincrónico. token   _Out_
Tipo: XTaskQueueRegistrationToken* Token que identifica el controlador de eventos.

​
Valor devuelto

Tipo: HRESULT Resultado de la función.

​
Comentarios

No es seguro llamar a esta función en un subproceso con restricciones de tiempo. Para obtener más información, consulte Subprocesos con restricciones de tiempo.
Dado que se admite la captura histórica de la aplicación, el sistema acumula metadatos escritos con AppCaptureMetadataWriter incluso cuando no se está capturando ni difundiendo activamente. Cuando, por ejemplo, una captura de los 30 segundos anteriores se escribe en un archivo de vídeo en disco, los metadatos asociados al intervalo de tiempo grabado se incluyen en el archivo. El sistema impone un límite al espacio de almacenamiento que se asigna por aplicación para almacenar los metadatos acumulados. Puede obtener el espacio de almacenamiento disponible actualmente comprobando la propiedad RemainingStorageBytesAvailable.
Cuando se haya llenado todo el espacio asignado, el sistema comenzará a purgar metadatos usando el valor de XAppCaptureMetadataPriority, especificado cuando se escribieron los elementos de metadatos, y la antigüedad de cada elemento, para eliminar primero los datos más antiguos y menos importantes. Cuando esto ocurre, se genera el evento MetadataPurged. En respuesta a este evento, puede optar por reducir la cantidad de metadatos que escribe la aplicación, pero no es obligatorio.

​
Requisitos

Encabezado: XAppCapture.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

​
Documentación conceptual

​
Consulte también

Información general de GameDVR
Miembros de XAppCapture
XAppCaptureUnRegisterMetadataPurged
Última modificación el 28 de agosto de 2026

Temas relacionados

XAppCaptureUnRegisterMetadataPurgedXAppCaptureMetadataPurgedCallbackXAppCaptureXAppCaptureMetadataRemainingStorageBytesAvailableXTaskQueueRegistrationToken