Skip to main content

​
XAppCaptureTakeDiagnosticScreenshot

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

​
Sintaxe

​
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 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* A captura de tela resultante.

​
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.
Ao contrário de XAppCaptureTakeScreenshot, chamar esta função não dispara uma notificação na interface do usuário. XAppCaptureTakeDiagnosticScreenshot usa 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 contém uma matriz de 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

​
Confira também

Visão geral do GameDVR
Membros de XAppCapture
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFormatFlag
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFile
Last modified on October 6, 2026