Метод IDirect3D9Ex::CreateDeviceEx (d3d9.h)

Статья
08/23/2023

Создает устройство, представляющее видеоадаптер.

Синтаксис

HRESULT CreateDeviceEx(
  [in]          UINT                  Adapter,
  [in]          D3DDEVTYPE            DeviceType,
  [in]          HWND                  hFocusWindow,
  [in]          DWORD                 BehaviorFlags,
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [in, out]     D3DDISPLAYMODEEX      *pFullscreenDisplayMode,
  [out, retval] IDirect3DDevice9Ex    **ppReturnedDeviceInterface
);

Параметры

[in] Adapter

Тип: UINT

Порядковый номер, обозначающий видеоадаптер. D3DADAPTER_DEFAULT всегда является основным видеоадаптером.

[in] DeviceType

Тип: D3DDEVTYPE

Указывает тип устройства. См . раздел D3DDEVTYPE. Если нужный тип устройства недоступен, метод завершится ошибкой.

[in] hFocusWindow

Тип: HWND

Окно фокуса оповещает Direct3D, когда приложение переключается из режима переднего плана в фоновый режим. Для полноэкранного режима указанное окно должно быть окном верхнего уровня. Для оконного режима этот параметр может иметь значение NULL , только если члену hDeviceWindow pPresentationParameters присвоено допустимое значение, отличное от NULL .

[in] BehaviorFlags

Тип: DWORD

Сочетание одного или нескольких параметров (см . раздел D3DCREATE), которые управляют созданием устройства.

[in, out] pPresentationParameters

Тип: D3DPRESENT_PARAMETERS*

Указатель на структуру D3DPRESENT_PARAMETERS , описывающую параметры презентации для создаваемого устройства. Если BehaviorFlags указывает D3DCREATE_ADAPTERGROUP_DEVICE, этот параметр является массивом. Независимо от количества существующих голов, автоматически создается только одна поверхность глубины или трафарета.

Этот параметр является как входным, так и выходным параметром. Вызов этого метода может изменить несколько элементов, в том числе:

Если BackBufferCount, BackBufferWidth и BackBufferHeight имеют значение 0 перед вызовом метода, они будут изменены при возврате метода.
Если BackBufferFormat равно D3DFMT_UNKNOWN перед вызовом метода, он будет изменен при возврате метода.

[in, out] pFullscreenDisplayMode

Тип: D3DDISPLAYMODEEX*

Режим отображения для полноэкранного режима устройства. См. раздел D3DDISPLAYMODEEX. Если BehaviorFlags указывает D3DCREATE_ADAPTERGROUP_DEVICE, этот параметр является массивом. Этот параметр должен иметь значение NULL для оконного режима.

[out, retval] ppReturnedDeviceInterface

Тип: IDirect3DDevice9Ex**

Адрес указателя на возвращенный объект IDirect3Device9Ex, представляющий созданное устройство.

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

Тип: HRESULT

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

Требования


Целевая платформа	Windows
Header	d3d9.h
Библиотека	D3D9.lib

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

IDirect3D9Ex

Поделиться через