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

查询设备的 GameDVR 设置，包括编码类型、颜色格式、分辨率、最大可能录制时长以及当前用户是否允许游戏进行捕获。

## 语法

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

### 参数

*userCaptureSettings* \_Out\_\
类型：XAppCaptureVideoCaptureSettings \*

函数返回时包含设备用于捕获分辨率的 GameDVR 设置。

### 返回值

类型：HRESULT

函数结果。

## 备注

**XAppCaptureGetVideoCaptureSettings** 返回的值可能会被用户随时更改。因此，建议在调用 [XAppCaptureRecordTimespan](/reference/system/xappcapture/functions/xappcapturerecordtimespan) 之前立即调用 **XAppCaptureGetVideoCaptureSettings**，以确保检索到最新的值。

可以通过如下方式获取 [XAppCaptureVideoCaptureSettings](/reference/system/xappcapture/structs/xappcapturevideocapturesettings) 结构。

```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);
}
```

## 要求

**头文件：** XAppCapture.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[XAppCapture 成员](/reference/system/xappcapture/xappcapture_members)


## Related topics

- [XAppCaptureVideoCaptureSettings](/zh-CN/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [XAppCapture](/zh-CN/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureVideoEncoding](/zh-CN/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XAppCaptureVideoColorFormat](/zh-CN/reference/system/xappcapture/enums/xappcapturevideocolorformat.md)
- [XAppCaptureLocalResult](/zh-CN/reference/system/xappcapture/structs/xappcapturelocalresult.md)