Skip to main content

​
XAppCaptureTakeDiagnosticScreenshot

Realiza una captura de pantalla de diagnóstico desde la aplicación.

​
Sintaxis

​
Parámetros

gamescreenOnly   _In_
Tipo: bool Determina si se capturará solo la pantalla del juego. Si se establece en false, es posible que se capture alguna interfaz de usuario, como un teclado en pantalla, además de la pantalla del juego. captureFlags   _In_
Tipo: XAppCaptureScreenshotFormatFlag Determina si la captura será SDR o HDR. filenamePrefix   _In_opt_
Tipo: char* Prefijo deseado para el nombre de archivo; es opcional y se anexará al principio del nombre del archivo de diagnóstico. result   _Out_
Tipo: XAppCaptureDiagnosticScreenshotResult* Captura de pantalla capturada resultante.

​
Valor devuelto

Tipo: HRESULT Resultado de la función.

​
Comentarios

No es seguro llamar a esta función en un subproceso con restricciones de tiempo. Para obtener más información, consulte Subprocesos con restricciones de tiempo.
A diferencia de XAppCaptureTakeScreenshot, llamar a esta función no desencadena una notificación de interfaz de usuario. XAppCaptureTakeDiagnosticScreenshot usa XAppCaptureScreenshotFormatFlag para designar si la captura de pantalla será en SDR, HDR o ambos. Sin embargo, debe estar ejecutándose en HDR para realizar una captura HDR. Las capturas de pantalla se guardan en una partición accesible para el juego. XAppCaptureDiagnosticScreenshotResult contiene una matriz de XAppCaptureScreenshotFile; cada estructura contiene una ruta de acceso de archivo a la captura de pantalla. Esta función solo estará disponible en kits de desarrollo. En kits comerciales, esta API devolverá un error inmediatamente.

​
Requisitos

Encabezado: XAppCapture.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

​
Documentación conceptual

​
Consulte también

Información general de GameDVR
Miembros de XAppCapture
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFormatFlag
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFile
Última modificación el 28 de agosto de 2026

Temas relacionados

XAppCaptureDiagnosticScreenshotResultXAppCaptureScreenshotFileXAppCaptureScreenshotFormatFlagXAppCaptureContenedores de API de C# de Unity para el GDK