> ## 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](/zh-TW/reference/system/xappcapture/functions/xappcapturerecordtimespan) 之前立即呼叫 **XAppCaptureGetVideoCaptureSettings**，以確保擷取到最新的值。

您可以如下所示取得 [XAppCaptureVideoCaptureSettings](/zh-TW/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 成員](/zh-TW/reference/system/xappcapture/xappcapture_members)


## Related topics

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