> ## 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](/ko/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [XAppCapture](/ko/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureVideoEncoding](/ko/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XAppCaptureVideoColorFormat](/ko/reference/system/xappcapture/enums/xappcapturevideocolorformat.md)
- [XAppCaptureUserRecordingResult](/ko/reference/system/xappcapture/structs/xappcaptureuserrecordingresult.md)