다음을 통해 공유


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, CreateSwapChainForCompositionSurfaceHandleGetDesc1 메서드에서 사용됩니다.

참고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 설정해야 합니다. 여러 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

추가 정보

DXGI 구조체

IDXGISwapChain1::GetDesc1