Метод IDirect3DDevice9::CreateAdditionalSwapChain (d3d9helper.h)

  • Статья

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

Синтаксис

HRESULT CreateAdditionalSwapChain(
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [out, retval] IDirect3DSwapChain9   **pSwapChain
);

Параметры

[in, out] pPresentationParameters

Тип: D3DPRESENT_PARAMETERS*

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

Вызов этого метода изменяет значение членов структуры D3DPRESENT_PARAMETERS.

  • Если BackBufferCount == 0, вызов CreateAdditionalSwapChain увеличит его до 1.
  • Если приложение находится в оконном режиме и если backBufferWidth или BackBufferHeight == 0, для них будет задана ширина и высота клиентской области hwnd.

[out, retval] pSwapChain

Тип: IDirect3DSwapChain9**

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

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается ошибкой, возвращается одно из следующих значений: D3DERR_NOTAVAILABLE, D3DERR_DEVICELOST, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.

Комментарии

Для каждого устройства всегда существует по крайней мере одна цепочка буферов (неявная цепочка буферов), так как Direct3D 9 имеет одну цепочку буферов в качестве свойства устройства.

Обратите внимание, что любое устройство может поддерживать только одну полноэкранную цепочку буферов.

D3DFMT_UNKNOWN можно указать для формата обратного буфера оконного режима при вызове IDirect3D9::CreateDevice, IDirect3DDevice9::Reset и CreateAdditionalSwapChain. Это означает, что приложению не нужно запрашивать текущий формат рабочего стола перед вызовом CreateDevice для оконного режима. Для полноэкранного режима необходимо указать формат обратного буфера.

Требования

Требование Значение
Целевая платформа Windows
Header d3d9helper.h (включая D3D9.h)
Библиотека D3D9.lib

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

IDirect3DDevice9

Представление нескольких представлений в оконном режиме (Direct3D 9)