структура DXGI_SWAP_CHAIN_DESC (dxgi.h)

Описывает цепочку буферов.

Синтаксис

typedef struct DXGI_SWAP_CHAIN_DESC {
  DXGI_MODE_DESC   BufferDesc;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  HWND             OutputWindow;
  BOOL             Windowed;
  DXGI_SWAP_EFFECT SwapEffect;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC;

Члены

BufferDesc

Тип: DXGI_MODE_DESC

Структура DXGI_MODE_DESC , описывающая режим отображения backbuffer.

SampleDesc

Тип: DXGI_SAMPLE_DESC

Структура DXGI_SAMPLE_DESC , описывающая параметры множественной выборки.

BufferUsage

Тип: DXGI_USAGE

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

BufferCount

Тип: UINT

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

OutputWindow

Тип: HWND

Дескриптор HWND для окна вывода. Этот элемент не должен иметь значение NULL.

Windowed

Тип: BOOL

Логическое значение, указывающее, находится ли вывод в оконном режиме. ЗНАЧЕНИЕ TRUE , если выходные данные отображаются в оконном режиме; в противном случае — FALSE.

Рекомендуется создать цепочку буферов с окном и разрешить конечному пользователю изменить цепочку буферов на полноэкранный режим с помощью IDXGISwapChain::SetFullscreenState; то есть не устанавливайте для этого элемента значение FALSE, чтобы принудить цепочку буферов к полноэкранным режимам. Однако если вы создаете цепочку буферов в полноэкранном режиме, также предоставьте конечному пользователю список поддерживаемых режимов отображения с помощью элемента BufferDesc , так как цепочка буферов, созданная с неподдерживаемого режима отображения, может привести к тому, что экран становится черным и не позволить конечному пользователю увидеть что-либо.

Дополнительные сведения о выборе оконных стихов в полноэкранном режиме см. в разделе IDXGIFactory::CreateSwapChain.

SwapEffect

Тип: DXGI_SWAP_EFFECT

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

Flags

Тип: UINT

Элемент перечисленного типа DXGI_SWAP_CHAIN_FLAG , описывающий параметры поведения цепочки буферов.

Комментарии

Эта структура используется методами GetDesc и CreateSwapChain .

В полноэкранном режиме имеется выделенный передний буфер; в оконном режиме рабочий стол является передним буфером.

При создании цепочки буферов с одним буфером указание DXGI_SWAP_EFFECT_SEQUENTIAL не приводит к переключении содержимого одного буфера на передний буфер.

Сведения о производительности перелистывания буферов цепочки буферов в полноэкранном приложении см. в разделе Указания по производительности полноэкранных приложений.

Требования

Верхняя часть	dxgi.h

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

Структуры DXGI

IDXGIFactory::CreateSwapChain

IDXGISwapChain