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 結構。 這個成員只有在 bit-block transfer (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 的 Quality 成員設定為零，因為不支援多個範例反鋸齒 (MSAA) ;您必須將 BufferCount 成員從 2 設定為 16。 如需翻轉模型交換鏈結的詳細資訊，請參閱 DXGI 翻轉模型。

規格需求

需求	值
最低支援的用戶端	適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
標頭	dxgi1_2.h

另請參閱

DXGI 結構

IDXGISwapChain1：：GetDesc1