> ## 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 as configurações do GameDVR do dispositivo, que incluem o tipo de codificação, o formato de cor, a resolução, a duração máxima possível de gravação e se o usuário atual permite capturas feitas por jogos.

## Sintaxe

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

### Parâmetros

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

No retorno da função, contém a configuração do GameDVR do dispositivo para a resolução de captura.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

Os valores retornados por **XAppCaptureGetVideoCaptureSettings** podem ser alterados pelo usuário a qualquer momento. Portanto, é recomendável chamar **XAppCaptureGetVideoCaptureSettings** logo antes de chamar [XAppCaptureRecordTimespan](/pt-BR/reference/system/xappcapture/functions/xappcapturerecordtimespan) para garantir que os valores mais recentes sejam recuperados.

O struct [XAppCaptureVideoCaptureSettings](/pt-BR/reference/system/xappcapture/structs/xappcapturevideocapturesettings) pode ser obtido da seguinte forma.

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

**Cabeçalho:** XAppCapture.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Membros de XAppCapture](/pt-BR/reference/system/xappcapture/xappcapture_members)


## Related topics

- [XAppCaptureGetVideoCaptureSettings](/es/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings.md)
- [XAppCaptureVideoCaptureSettings](/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)