> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturerecordtimespan.md) para garantir que os valores mais recentes sejam recuperados.

O struct [XAppCaptureVideoCaptureSettings](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md) 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](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)


## Related topics

- [XAppCaptureVideoCaptureSettings](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [XAppCapture (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureVideoEncoding](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XAppCaptureVideoColorFormat](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturevideocolorformat.md)
- [XAppCaptureRecordClipResult](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)