Skip to main content

XAppCaptureTakeScreenshot

Faz uma captura de tela.

Sintaxe

Parâmetros

requestingUser   _In_
Tipo: XUserHandle
Identificador que representa o usuário que está solicitando a captura de tela. result   _Out_
Tipo: XAppCaptureTakeScreenshotResult*
Resultados da captura de tela retornados.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

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.
[!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 (Persistent Local Storage), o armazenamento conectado (por exemplo, XGameSave ou XGameSaveFiles) 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 e lendo a captura de tela com XAppCaptureReadScreenshotStream. Ambas as funções exigirão que você use a ID local retornada no XAppCaptureTakeScreenshotResult retornado por esta função.

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

Confira também

Visão geral do GameDVR
Membros de XAppCapture
XAppCaptureOpenScreenShotStream
XAppCaptureReadScreenShotStream
XAppCaptureCloseScreenshotStream
XAppCaptureTakeScreenshotResult
Last modified on October 6, 2026