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

SampleDesc

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

BufferUsage

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

BufferCount

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

Scaling

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

SwapEffect

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

AlphaMode

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

Flags

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

Комментарии

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

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

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

Требования

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

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

Структуры DXGI

IDXGISwapChain1::GetDesc1