> ## 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 um manipulador de eventos para eventos de limpeza de metadados.

## Sintaxe

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

### Parâmetros

*queue*   \_In\_opt\_\
Tipo: XTaskQueueHandle

Fila assíncrona para processar o trabalho assíncrono. Se não for atribuída, uma fila assíncrona padrão será criada.

*context*   \_In\_\
Tipo: void\*

Informações a serem passadas para a função de retorno de chamada. Normalmente, o objeto chamador.

*callback*   \_In\_\
Tipo: XAppCaptureMetadataPurgedCallback\*

Função de retorno de chamada a ser chamada após a conclusão do trabalho assíncrono.

*token*   \_Out\_\
Tipo: XTaskQueueRegistrationToken\*

Token que identifica o manipulador de eventos.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

<Note>Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Como há suporte para a captura histórica de aplicativos, o sistema acumula metadados gravados com **AppCaptureMetadataWriter** mesmo quando não está capturando ou transmitindo ativamente. Quando, por exemplo, uma captura dos 30 segundos anteriores é gravada em um arquivo de vídeo no disco, os metadados associados à janela de tempo gravada são incluídos no arquivo. O sistema impõe um limite ao espaço de armazenamento alocado por aplicativo para armazenar os metadados acumulados. Você pode obter o espaço de armazenamento disponível no momento verificando a propriedade RemainingStorageBytesAvailable.\
Quando todo o espaço alocado estiver preenchido, o sistema começará a limpar os metadados usando o valor de [XAppCaptureMetadataPriority](/pt-BR/reference/system/xappcapture/enums/xappcapturemetadatapriority), especificado quando os itens de metadados foram gravados, e a idade de cada item, a fim de excluir primeiro os dados mais antigos e menos importantes. Quando isso ocorre, o evento **MetadataPurged** é gerado. Em resposta a esse evento, você pode optar por reduzir a quantidade de metadados que seu aplicativo está gravando, mas isso não é obrigatório.

## Requisitos

**Cabeçalho:** XAppCapture.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[Visão geral do GameDVR](/pt-BR/build/console-features/game-dvr/gamedvr-broadcast)\
[Membros de XAppCapture](/pt-BR/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureUnRegisterMetadataPurged](/pt-BR/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged)


## Related topics

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