> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\*](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)

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

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](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult.md) 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](https://docs.xbox.com/pt-BR/build/console-features/game-dvr/gamedvr-broadcast.md)\
[Membros de XAppCapture](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)\
[XAppCaptureRecordDiagnosticClipResult](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)


## Related topics

- [XAppCaptureRecordClipResult](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCapture (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)
- [Usar wrappers C# para APIs do GDK no seu projeto do Unity](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XAppCaptureVideoEncoding](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XAppCaptureUserRecordingResult](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcaptureuserrecordingresult.md)