Skip to main content

​
XAppCaptureRecordDiagnosticClip

Grava um clipe de diagnóstico do seu aplicativo.

​
Sintaxe

​
Parâmetros

startTime   _In_
Tipo: time_t Carimbo de data/hora do início do clipe de diagnóstico. durationInMs   _In_
Tipo: uint32_t Duração do clipe de diagnóstico em milissegundos. filenamePrefix   _In_opt_
Tipo: char* Prefixo desejado para o nome do arquivo; é opcional e será acrescentado ao início do nome do arquivo de diagnóstico. result   _Out_
Tipo: XAppCaptureRecordClipResult* O clipe de diagnóstico gravado resultante.

​
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.
Chamar esta função não dispara uma notificação na interface do usuário. Os clipes são salvos em uma partição acessível pelo jogo. O XAppCaptureRecordDiagnosticClipResult contém um caminho de arquivo que você pode usar para acessar o clipe. No XBOX, esta função só estará disponível em kits de desenvolvimento. Em kits de varejo, esta API retornará um erro imediatamente. No PC, você deve habilitar a gravação em segundo plano para o seu aplicativo para que esta função funcione. A melhor maneira de fazer isso é abrir a Game Bar pressionando Win+G, clicar no ícone de Configurações, ir para a guia Capturando e habilitar “Gravar em segundo plano enquanto eu estiver jogando”. Em seguida, você deve marcar seu aplicativo como um jogo. A melhor maneira de fazer isso é executar seu jogo primeiro. Com o jogo em foco, abra a Game Bar pressionando Win+G, clique no ícone de Configurações, vá para a guia Geral e marque “Lembrar que isto é um jogo”.

​
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

​
Confira também

Visão geral do GameDVR
Membros de XAppCapture
XAppCaptureRecordDiagnosticClipResult
Last modified on October 6, 2026