XAppCaptureTakeScreenshot

Realiza una captura de pantalla.

Sintaxis

HRESULT XAppCaptureTakeScreenshot(  
         XUserHandle requestingUser,  
         XAppCaptureTakeScreenshotResult* result  
)  

Parámetros

requestingUser _In_
Tipo: XUserHandle Identificador que representa al usuario que solicita la captura de pantalla. result _Out_
Tipo: XAppCaptureTakeScreenshotResult* Resultados de la captura de pantalla devuelta.

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.
[!NOTE] Esta función no se admite en XBOX Game Streaming. Consulte la sección Requisitos a continuación para ver qué plataformas la admiten.
[!NOTE] Las capturas de pantalla más antiguas se eliminarán cuando el espacio asignado se llene, para hacer sitio a las nuevas capturas de pantalla. Use PLS (almacenamiento local persistente), almacenamiento conectado (p. ej., XGameSave o XGameSaveFiles) o un sistema de almacenamiento similar para conservar las capturas de pantalla durante un período de tiempo determinado.

XAppCaptureTakeScreenshot realiza una captura de pantalla como si el usuario la hubiera desencadenado. Esto mostrará una notificación del sistema y guardará la captura de pantalla del juego. Si el juego se está ejecutando en SDR, se genera un único archivo. Si el juego se está ejecutando en HDR, se generan dos archivos, uno en formato HDR y otro en formato SDR. Las capturas de pantalla pueden cargarse automáticamente en XBOX Live según las preferencias del usuario. Una vez realizada correctamente la captura de pantalla, el archivo resultante puede leerse abriendo la secuencia de captura de pantalla con XAppCaptureOpenScreenShotStream y leyendo la captura de pantalla con XAppCaptureReadScreenshotStream. Ambas funciones requerirán que use el id. local devuelto en el XAppCaptureTakeScreenshotResult que devuelve esta función.

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

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

Documentación conceptual

Subprocesos con restricciones de tiempo

Consulte también

Información general de GameDVR
Miembros de XAppCapture
XAppCaptureOpenScreenShotStream
XAppCaptureReadScreenShotStream
XAppCaptureCloseScreenshotStream
XAppCaptureTakeScreenshotResult

Última modificación el 28 de agosto de 2026

Temas relacionados

XAppCaptureTakeScreenshotResult XAppCaptureOpenScreenshotStream XAppCaptureScreenshotStream XAppCaptureTakeDiagnosticScreenshot XAppCaptureReadScreenshotStream

⌘I

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XAppCaptureTakeScreenshot

XAppCaptureTakeScreenshot

Sintaxis

Parámetros

Valor devuelto

Comentarios

Requisitos

Documentación conceptual

Consulte también

​XAppCaptureTakeScreenshot

​Sintaxis

​Parámetros

​Valor devuelto

​Comentarios

​Requisitos

​Documentación conceptual

​Consulte también

XAppCaptureTakeScreenshot

Sintaxis

Parámetros

Valor devuelto

Comentarios

Requisitos

Documentación conceptual

Consulte también