> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppCaptureRegisterMetadataPurged

> AppCaptureRegisterMetadataPurged

# AppCaptureRegisterMetadataPurged

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

## Sintaxis

```cpp theme={null}
HRESULT XAppCaptureRegisterMetadataPurged(  
         XTaskQueueHandle queue,  
         void* context,  
         XAppCaptureMetadataPurgedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

### 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

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

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](/reference/system/xappcapture/enums/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

* [Subprocesos con restricciones de tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[Información general de GameDVR](/build/console-features/game-dvr/gamedvr-broadcast)\
[Miembros de XAppCapture](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureUnRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged)


## Related topics

- [XAppCaptureUnRegisterMetadataPurged](/es/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged.md)
- [XAppCaptureMetadataPurgedCallback](/es/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback.md)
- [XAppCapture](/es/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureMetadataRemainingStorageBytesAvailable](/es/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable.md)
- [XTaskQueueRegistrationToken](/es/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)