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

참고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