DXGI_SWAP_CHAIN_DESC1 结构 (dxgi1_2.h)

  • 项目

描述交换链。

语法

typedef struct DXGI_SWAP_CHAIN_DESC1 {
  UINT             Width;
  UINT             Height;
  DXGI_FORMAT      Format;
  BOOL             Stereo;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  DXGI_SCALING     Scaling;
  DXGI_SWAP_EFFECT SwapEffect;
  DXGI_ALPHA_MODE  AlphaMode;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC1;

成员

Width

描述分辨率宽度的值。 如果在调用 IDXGIFactory2：：CreateSwapChainForHwnd 方法创建交换链时将宽度指定为零，运行时将从输出窗口获取宽度，并将此宽度值分配给交换链说明。 随后可以调用 IDXGISwapChain1：：GetDesc1 方法来检索分配的宽度值。 调用 IDXGIFactory2：：CreateSwapChainForComposition 方法时，不能将宽度指定为零。

Height

描述分辨率高度的值。 如果在调用 IDXGIFactory2：：CreateSwapChainForHwnd 方法创建交换链时将高度指定为零，运行时将从输出窗口获取高度，并将此高度值分配给交换链说明。 随后可以调用 IDXGISwapChain1：：GetDesc1 方法来检索分配的高度值。 调用 IDXGIFactory2：：CreateSwapChainForComposition 方法时，不能将高度指定为零。

Format

描述显示格式 的DXGI_FORMAT 结构。

Stereo

指定全屏显示模式还是交换链后台缓冲区是立体声的。 如果立体声，则为 TRUE;否则为 FALSE。 如果指定立体声，还必须指定翻转模型交换链 (即在 SwapEffect 成员) 中设置了DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL值的交换链。

SampleDesc

描述多采样参数 的DXGI_SAMPLE_DESC 结构。 此成员仅对位块传输 (bitblt) 模型交换链有效。

BufferUsage

一个DXGI_USAGE类型的值，用于描述后台缓冲区的图面使用情况和 CPU 访问选项。 后台缓冲区可用于着色器输入或呈现目标输出。

BufferCount

一个 值，该值描述交换链中的缓冲区数。 创建全屏交换链时，通常会在此值中包含前缓冲区。

Scaling

一个DXGI_SCALING类型的值，用于标识后台缓冲区的大小不等于目标输出时的大小调整行为。

SwapEffect

一个DXGI_SWAP_EFFECT类型的值，用于描述交换链使用的演示模型，以及呈现图面后用于处理演示缓冲区内容的选项。 调用 IDXGIFactory2：：CreateSwapChainForComposition 方法时，必须指定DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL值，因为此方法仅支持翻转表示模型。

AlphaMode

一个 DXGI_ALPHA_MODE类型的值，用于标识交换链后缓冲区的透明度行为。

Flags

使用按位 OR 运算组合 的DXGI_SWAP_CHAIN_FLAG类型值的组合。 生成的值指定交换链行为的选项。

注解

此结构由 CreateSwapChainForHwnd、 CreateSwapChainForCoreWindow、 CreateSwapChainForComposition、 CreateSwapChainForCompositionSurfaceHandle 和 GetDesc1 方法使用。

注意 不能将 DXGI_SWAP_CHAIN_DESC1 强制转换为 DXGI_SWAP_CHAIN_DESC ，反之亦然。 应用程序必须显式使用 IDXGISwapChain1：：GetDesc1 方法检索较新版本的交换链说明结构。
 
在全屏模式下，有一个专用的前面缓冲区;在窗口模式中，桌面是前缓冲区。

对于翻转模型交换链 (即在 SwapEffect 成员) 中设置了DXGI_SWAP_EFFECT_FLIP_DISCARD或DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL值的交换链，必须将 Format 成员设置为 DXGI_FORMAT_R16G16B16A16_FLOAT、DXGI_FORMAT_B8G8R8A8_UNORM、DXGI_FORMAT_R8G8B8A8_UNORM 或 DXGI_FORMAT_R10G10B10A10_UNORM;必须将 SampleDesc 成员指定的 DXGI_SAMPLE_DESC 结构的 Count 成员设置为 1，并将 DXGI_SAMPLE_DESC的质量成员设置为零，因为不支持多个样本抗锯齿 (MSAA) ;必须将 BufferCount 成员设置为 2 到 16。 有关翻转模型交换链的详细信息，请参阅 DXGI 翻转模型。

要求

要求 值
最低受支持的客户端 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用]
标头 dxgi1_2.h

另请参阅

DXGI 结构

IDXGISwapChain1：：GetDesc1