> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAppCaptureTakeScreenshot

> XAppCaptureTakeScreenshot

# XAppCaptureTakeScreenshot

Realiza una captura de pantalla.

## Sintaxis

```cpp theme={null}
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\*](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)

Resultados de la captura de pantalla devuelta.

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).\
\[!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](/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members) (almacenamiento local persistente), almacenamiento conectado (p. ej., [XGameSave](/reference/system/xgamesave/xgamesave_members) o [XGameSaveFiles](/reference/system/xgamesavefiles/xgamesavefiles_members)) o un sistema de almacenamiento similar para conservar las capturas de pantalla durante un período de tiempo determinado.</Note>

**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](/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream) y leyendo la captura de pantalla con [XAppCaptureReadScreenshotStream](/reference/system/xappcapture/functions/xappcapturereadscreenshotstream). Ambas funciones requerirán que use el id. local devuelto en el [XAppCaptureTakeScreenshotResult](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult) que devuelve esta función.

```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

**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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[Información general de GameDVR](/build/console-features/game-dvr/gamedvr-broadcast)\
[Miembros de XAppCapture](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureOpenScreenShotStream](/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream)\
[XAppCaptureReadScreenShotStream](/reference/system/xappcapture/functions/xappcapturereadscreenshotstream)\
[XAppCaptureCloseScreenshotStream](/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream)\
[XAppCaptureTakeScreenshotResult](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)


## Related topics

- [XAppCaptureTakeScreenshotResult](/es/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)
- [XAppCaptureOpenScreenshotStream](/es/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)
- [XAppCaptureScreenshotStream](/es/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureTakeDiagnosticScreenshot](/es/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)
- [XAppCaptureReadScreenshotStream](/es/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md)