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 메서드를 호출하여 스왑 체인을 만들 때 너비를 0으로 지정하면 런타임은 출력 창에서 너비를 가져오고 이 너비 값을 스왑 체인 설명에 할당합니다. 이후에 IDXGISwapChain1::GetDesc1 메서드를 호출하여 할당된 너비 값을 검색할 수 있습니다. IDXGIFactory2::CreateSwapChainForComposition 메서드를 호출할 때 너비를 0으로 지정할 수 없습니다.
Height
해상도 높이를 설명하는 값입니다. IDXGIFactory2::CreateSwapChainForHwnd 메서드를 호출하여 스왑 체인을 만들 때 높이를 0으로 지정하면 런타임은 출력 창에서 높이를 가져오고 이 높이 값을 스왑 체인 설명에 할당합니다. 이후에 IDXGISwapChain1::GetDesc1 메서드를 호출하여 할당된 높이 값을 검색할 수 있습니다. IDXGIFactory2::CreateSwapChainForComposition 메서드를 호출할 때 높이를 0으로 지정할 수 없습니다.
Format
표시 형식을 설명하는 DXGI_FORMAT 구조체입니다.
Stereo
전체 화면 표시 모드 또는 스왑 체인 백 버퍼가 스테레오인지 여부를 지정합니다. TRUE 이면 스테레오; 그렇지 않으면 FALSE입니다. 스테레오를 지정하는 경우 대칭 이동 모델 스왑 체인(즉, SwapEffect 멤버에 설정된 DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL 값이 있는 스왑 체인)도 지정해야 합니다.
SampleDesc
다중 샘플링 매개 변수를 설명하는 DXGI_SAMPLE_DESC 구조체입니다. 이 멤버는 비트 블록 전송(bitblt) 모델 스왑 체인에서만 유효합니다.
BufferUsage
백 버퍼의 표면 사용량 및 CPU 액세스 옵션을 설명하는 DXGI_USAGE 형식의 값입니다. 백 버퍼는 셰이더 입력 또는 렌더링 대상 출력에 사용할 수 있습니다.
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 메서드에서 사용됩니다.
대칭 이동 모델 스왑 체인(즉, 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 설정해야 합니다. 여러 MSAA(샘플 앤티앨리어싱)가 지원되지 않으므로 SampleDesc 멤버가 지정하는 DXGI_SAMPLE_DESC 구조의 Count 멤버를 1로 설정하고 DXGI_SAMPLE_DESCQuality 멤버를 0으로 설정해야 합니다. BufferCount 멤버를 2에서 16으로 설정해야 합니다. 플립 모델 스왑 체인에 대한 자세한 내용은 DXGI Flip Model을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 머리글 | dxgi1_2.h |