структура 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. При указании стерео также необходимо указать цепочку буферов модели переворачивания (т. е. цепочку буферов, которая имеет значение DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL , заданное в элементе SwapEffect ).

SampleDesc

Структура DXGI_SAMPLE_DESC , описывающая параметры множественной выборки. Этот член действителен только с цепочками буферов модели передачи битовых блоков (bitblt).

BufferUsage

DXGI_USAGE типизированное значение, описывающее использование поверхности и параметры доступа к ЦП для заднего буфера. Задний буфер можно использовать для входных данных шейдера или вывода целевого объекта отрисовки.

BufferCount

Значение типа , описывающее количество буферов в цепочке буферов. При создании цепочки буферов в полноэкранном режиме в это значение обычно включается передний буфер.

Scaling

DXGI_SCALING типизированное значение, определяющее поведение изменения размера, если размер заднего буфера не равен целевому выходу.

SwapEffect

DXGI_SWAP_EFFECT типизированное значение, описывающее модель представления, используемую цепочкой буферов, и параметры для обработки содержимого буфера презентации после представления поверхности. Необходимо указать значение DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL при вызове метода IDXGIFactory2::CreateSwapChainForComposition , так как этот метод поддерживает только модель представления с отражением.

AlphaMode

DXGI_ALPHA_MODE типизированное значение, определяющее поведение прозрачности буфера обратной цепочки буферов.

Flags

Сочетание DXGI_SWAP_CHAIN_FLAG типизированных значений, объединенных с помощью побитовой операции ИЛИ. Полученное значение задает параметры поведения цепочки буферов.

Комментарии

Эта структура используется методами CreateSwapChainForHwnd, CreateSwapChainForCoreWindow, CreateSwapChainForComposition, CreateSwapChainForCompositionSurfaceHandle и GetDesc1 .

Примечание Нельзя привести DXGI_SWAP_CHAIN_DESC1 к DXGI_SWAP_CHAIN_DESC и наоборот. Приложение должно явно использовать метод IDXGISwapChain1::GetDesc1 для получения более новой версии структуры описания цепочки буферов.
 
В полноэкранном режиме имеется выделенный передний буфер; в оконном режиме рабочий стол является передним буфером.

Для цепочки буферов модели переворачивания (т. е. цепочки буферов, которая содержит значение DXGI_SWAP_EFFECT_FLIP_DISCARD или DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL , заданное в элементе SwapEffect ), необходимо задать для элемента Formatзначение DXGI_FORMAT_R16G16B16A16_FLOAT, DXGI_FORMAT_B8G8R8A8_UNORM или DXGI_FORMAT_R8G8B8A8_UNORM. Необходимо задать для элемента Countструктуры DXGI_SAMPLE_DESC , указанной в элементе SampleDesc , значение 1, а для элемента QualityDXGI_SAMPLE_DESC значение 0, так как сглаживание с несколькими выборками (MSAA) не поддерживается; Необходимо задать для элемента BufferCount значение от двух до шестнадцати. Дополнительные сведения о цепочке буферов модели переворачивания см. в разделе DXGI Flip Model.

Требования

   
Минимальная версия клиента Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Верхняя часть dxgi1_2.h

См. также раздел

Структуры DXGI

IDXGISwapChain1::GetDesc1