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

# XAppCaptureTakeScreenshot

> XAppCaptureTakeScreenshot

# XAppCaptureTakeScreenshot

Faz uma captura de tela.

## Sintaxe

```cpp theme={null}
HRESULT XAppCaptureTakeScreenshot(  
         XUserHandle requestingUser,  
         XAppCaptureTakeScreenshotResult* result  
)  
```

### Parâmetros

*requestingUser*   \_In\_\
Tipo: XUserHandle

Identificador que representa o usuário que está solicitando a captura de tela.

*result*   \_Out\_\
Tipo: [XAppCaptureTakeScreenshotResult\*](/pt-BR/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)

Resultados da captura de tela retornados.

### 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]
Esta função não tem suporte no XBOX Game Streaming. Consulte a seção Requisitos abaixo para ver quais plataformas oferecem suporte a ela.\
\[!NOTE]
As capturas de tela mais antigas serão excluídas quando o espaço alocado estiver cheio, para abrir espaço para novas capturas de tela. Use [PLS](/pt-BR/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members) (Persistent Local Storage), o armazenamento conectado (por exemplo, [XGameSave](/pt-BR/reference/system/xgamesave/xgamesave_members) ou [XGameSaveFiles](/pt-BR/reference/system/xgamesavefiles/xgamesavefiles_members)) ou um sistema de armazenamento semelhante para reter capturas de tela por um período de tempo definido.</Note>

**XAppCaptureTakeScreenshot** faz uma captura de tela como se o usuário a tivesse disparado. Isso exibirá uma notificação do sistema e salvará a captura de tela do jogo.
Se o jogo estiver sendo executado em SDR, um único arquivo será gerado. Se o jogo estiver sendo executado em HDR, dois arquivos serão gerados, um no formato HDR e outro no formato SDR.
As capturas de tela podem ser carregadas automaticamente no XBOX Live, dependendo da preferência do usuário. Depois que a captura de tela for feita com êxito, o arquivo resultante poderá ser lido abrindo o fluxo da captura de tela com [XAppCaptureOpenScreenShotStream](/pt-BR/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream) e lendo a captura de tela com [XAppCaptureReadScreenshotStream](/pt-BR/reference/system/xappcapture/functions/xappcapturereadscreenshotstream). Ambas as funções exigirão que você use a ID local retornada no [XAppCaptureTakeScreenshotResult](/pt-BR/reference/system/xappcapture/structs/xappcapturetakescreenshotresult) retornado por esta função.

```cpp theme={null}
XAppCaptureTakeScreenshotResult takeScreenshotResult = {0};
XUserHandle user = nullptr;
/* See XUserAddAsync, XUserAddResult on how to initialize XUserHandle */
bool hasHDR = false;

LOG_IF_FAILED(XAppCaptureTakeScreenshot(user, &takeScreenshotResult));

hasHDR = static_cast<bool>(takeScreenshotResult.availableScreenshotFormats & XAppCaptureScreenshotFormatFlag::HDR);

appLog.AddLog("LocalId %s (%s)\n", takeScreenshotResult.localId, hasHDR ? "SDR & HDR" : "SDR only");
```

## 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)\
[XAppCaptureOpenScreenShotStream](/pt-BR/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream)\
[XAppCaptureReadScreenShotStream](/pt-BR/reference/system/xappcapture/functions/xappcapturereadscreenshotstream)\
[XAppCaptureCloseScreenshotStream](/pt-BR/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream)\
[XAppCaptureTakeScreenshotResult](/pt-BR/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)


## Related topics

- [XAppCaptureTakeScreenshot](/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)
- [XAppCaptureTakeScreenshotResult](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)
- [XAppCaptureScreenshotStream](/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureOpenScreenshotStream](/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)
- [XAppCaptureTakeDiagnosticScreenshot](/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)