AppCaptureRegisterMetadataPurged

Sintaxe

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

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.

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, 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.

Porting

Build Paths

AppCaptureRegisterMetadataPurged

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Documentação conceitual

Confira também

​AppCaptureRegisterMetadataPurged

​Sintaxe

​Parâmetros

​Valor retornado

​Comentários

​Requisitos

​Documentação conceitual

​Confira também

AppCaptureRegisterMetadataPurged

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Documentação conceitual

Confira também