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

# XAppCaptureGetVideoCaptureSettings

> XAppCaptureGetVideoCaptureSettings

# XAppCaptureGetVideoCaptureSettings

Consulta la configuración de GameDVR del dispositivo, que incluye el tipo de codificación, el formato de color, la resolución, la duración máxima posible de la grabación y si el usuario actual permite las capturas por parte de los juegos.

## Sintaxis

```cpp theme={null}
HRESULT XAppCaptureGetVideoCaptureSettings(
  XAppCaptureVideoCaptureSettings * userCaptureSettings
)
```

### Parámetros

*userCaptureSettings* \_Out\_\
Tipo: XAppCaptureVideoCaptureSettings \*

Al devolver la función, contiene la configuración de GameDVR del dispositivo para la resolución de captura.

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

El usuario puede cambiar en cualquier momento los valores que devuelve **XAppCaptureGetVideoCaptureSettings**. Por lo tanto, se recomienda llamar a **XAppCaptureGetVideoCaptureSettings** justo antes de llamar a [XAppCaptureRecordTimespan](/reference/system/xappcapture/functions/xappcapturerecordtimespan) para garantizar que se recuperan los valores más recientes.

La estructura [XAppCaptureVideoCaptureSettings](/reference/system/xappcapture/structs/xappcapturevideocapturesettings) se puede obtener de la siguiente manera.

```cpp theme={null}
XAppCaptureVideoCaptureSettings captureSettings = { 0 };

if (SUCCEEDED(XAppCaptureGetVideoCaptureSettings(&captureSettings)))
{
    appLog.AddLog("Color Format: %s , encoding: %s, Width: %lu, Height %lu, Max RecordTimespan duration: %llu, Capture Permitted: %d\n",
        (captureSettings.colorFormat == XAppCaptureVideoColorFormat::SDR) ? "SDR" : "HDR",
        (captureSettings.encoding == XAppCaptureVideoEncoding::H264) ? "H264" : "HEVC",
        captureSettings.width,
        captureSettings.height,
        captureSettings.maxRecordTimespanDurationInMs,
        captureSettings.isCaptureByGamesAllowed);
}
```

## Requisitos

**Encabezado:** XAppCapture.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Miembros de XAppCapture](/reference/system/xappcapture/xappcapture_members)


## Related topics

- [XAppCaptureVideoCaptureSettings](/es/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [XAppCapture](/es/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureVideoEncoding](/es/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XAppCaptureVideoColorFormat](/es/reference/system/xappcapture/enums/xappcapturevideocolorformat.md)
- [XAppCaptureRecordClipResult](/es/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)