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

# 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\*](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)

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](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md) (Persistent Local Storage), o armazenamento conectado (por exemplo, [XGameSave](https://docs.xbox.com/pt-BR/reference/system/xgamesave/xgamesave_members.md) ou [XGameSaveFiles](https://docs.xbox.com/pt-BR/reference/system/xgamesavefiles/xgamesavefiles_members.md)) ou um sistema de armazenamento semelhante para reter capturas de tela por um período de tempo definido.

**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](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md) e lendo a captura de tela com [XAppCaptureReadScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md). Ambas as funções exigirão que você use a ID local retornada no [XAppCaptureTakeScreenshotResult](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md) 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](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)\
[XAppCaptureOpenScreenShotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)\
[XAppCaptureReadScreenShotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md)\
[XAppCaptureCloseScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream.md)\
[XAppCaptureTakeScreenshotResult](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)


## Related topics

- [XAppCaptureTakeScreenshotResult](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)
- [XAppCaptureOpenScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)
- [XAppCaptureScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureTakeDiagnosticScreenshot](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)
- [XAppCaptureReadScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md)