> ## 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.

# XAppCaptureTakeDiagnosticScreenshot

> XAppCaptureTakeDiagnosticScreenshot

# XAppCaptureTakeDiagnosticScreenshot

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

## Sintaxis

```cpp theme={null}
HRESULT XAppCaptureTakeDiagnosticScreenshot(  
         bool gamescreenOnly,  
         XAppCaptureScreenshotFormatFlag captureFlags,  
         const char* filenamePrefix,  
         XAppCaptureDiagnosticScreenshotResult* result  
)  
```

### 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](/reference/system/xappcapture/enums/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\*](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)

Captura de pantalla capturada resultante.

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

A diferencia de [XAppCaptureTakeScreenshot](/reference/system/xappcapture/functions/xappcapturetakescreenshot), llamar a esta función no desencadena una notificación de interfaz de usuario. **XAppCaptureTakeDiagnosticScreenshot** usa [XAppCaptureScreenshotFormatFlag](/reference/system/xappcapture/enums/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](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult) contiene una matriz de [XAppCaptureScreenshotFile](/reference/system/xappcapture/structs/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

* [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)\
[XAppCaptureDiagnosticScreenshotResult](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFormatFlag](/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)\
[XAppCaptureDiagnosticScreenshotResult](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFile](/reference/system/xappcapture/structs/xappcapturescreenshotfile)


## Related topics

- [XAppCaptureDiagnosticScreenshotResult](/es/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md)
- [XAppCaptureScreenshotFile](/es/reference/system/xappcapture/structs/xappcapturescreenshotfile.md)
- [XAppCaptureScreenshotFormatFlag](/es/reference/system/xappcapture/enums/xappcapturescreenshotformatflag.md)
- [XAppCapture](/es/reference/system/xappcapture/xappcapture_members.md)
- [Contenedores de API de C# de Unity para el GDK](/es/build/gdk-and-engines/unity/unity-api-wrappers.md)