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

# XAppCaptureRecordDiagnosticClip

> XAppCaptureRecordDiagnosticClip

# XAppCaptureRecordDiagnosticClip

Grava um clipe de diagnóstico do seu aplicativo.

## Sintaxe

```cpp theme={null}
HRESULT XAppCaptureRecordDiagnosticClip(  
         time_t startTime,  
         uint32_t durationInMs,  
         const char* filenamePrefix,  
         XAppCaptureRecordClipResult* result  
)  
```

### 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\*](/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult)

O clipe de diagnóstico gravado resultante.

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

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](/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult) 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

* [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)\
[XAppCaptureRecordDiagnosticClipResult](/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult)


## Related topics

- [XAppCaptureRecordDiagnosticClip](/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [XAppCaptureRecordClipResult](/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)