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

# XAppCaptureTakeDiagnosticScreenshot

> XAppCaptureTakeDiagnosticScreenshot

# XAppCaptureTakeDiagnosticScreenshot

Captura uma captura de tela de diagnóstico do seu aplicativo.

## Sintaxe

```cpp theme={null}
HRESULT XAppCaptureTakeDiagnosticScreenshot(  
         bool gamescreenOnly,  
         XAppCaptureScreenshotFormatFlag captureFlags,  
         const char* filenamePrefix,  
         XAppCaptureDiagnosticScreenshotResult* result  
)  
```

### Parâmetros

*gamescreenOnly*   \_In\_\
Tipo: bool

Determina se apenas a tela do jogo será capturada. Se definido como false, é possível que alguma interface do usuário, como um teclado na tela, seja capturada além da tela do jogo.

*captureFlags*   \_In\_\
Tipo: [XAppCaptureScreenshotFormatFlag](/pt-BR/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)

Determina se a captura será SDR ou HDR.

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

A captura de tela 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>

Ao contrário de [XAppCaptureTakeScreenshot](/pt-BR/reference/system/xappcapture/functions/xappcapturetakescreenshot), chamar esta função não dispara uma notificação na interface do usuário. **XAppCaptureTakeDiagnosticScreenshot** usa [XAppCaptureScreenshotFormatFlag](/pt-BR/reference/system/xappcapture/enums/xappcapturescreenshotformatflag) para designar se a captura de tela será em SDR, HDR ou ambos. No entanto, você ainda precisa estar executando em HDR para fazer uma captura HDR. As capturas de tela são salvas em uma partição acessível pelo jogo. O [XAppCaptureDiagnosticScreenshotResult](/pt-BR/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult) contém uma matriz de [XAppCaptureScreenshotFile](/pt-BR/reference/system/xappcapture/structs/xappcapturescreenshotfile); cada struct contém um caminho de arquivo para a captura de tela.

Esta função só estará disponível em kits de desenvolvimento. Em kits de varejo, esta API retornará um erro imediatamente.

## 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)\
[XAppCaptureDiagnosticScreenshotResult](/pt-BR/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFormatFlag](/pt-BR/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)\
[XAppCaptureDiagnosticScreenshotResult](/pt-BR/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFile](/pt-BR/reference/system/xappcapture/structs/xappcapturescreenshotfile)


## Related topics

- [XAppCaptureTakeDiagnosticScreenshot](/zh-CN/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)
- [XAppCaptureDiagnosticScreenshotResult](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md)