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