Функция D3DX10CreateDevice

Статья
06/12/2023

Создайте лучшее устройство Direct3D 10, представляющее видеоадаптер. Если можно создать устройство, совместимое с Direct3D 10.1, можно будет получить указатель интерфейса ID3D10Device1 из возвращенного указателя интерфейса устройства.

Синтаксис

HRESULT D3DX10CreateDevice(
  _In_  IDXGIAdapter      *pAdapter,
  _In_  D3D10_DRIVER_TYPE DriverType,
  _In_  HMODULE           Software,
  _In_  UINT              Flags,
  _Out_ ID3D10Device      **ppDevice
);

Параметры

pAdapter [in]

Тип: IDXGIAdapter*

Указатель на видеоадаптер (см. интерфейс IDXGIAdapter ) при создании аппаратного устройства; в противном случае задайте для этого параметра значение NULL. Если при создании аппаратного устройства задано значение NULL , Direct3D будет использовать первый адаптер, перечисляемый интерфейсом IDXGIFactory .

DriverType [in]

Тип: D3D10_DRIVER_TYPE

Тип драйвера устройства (см. перечисление D3D10_DRIVER_TYPE ). Тип драйвера определяет тип создаваемого устройства.

Программное обеспечение [в]

Тип: HMODULE

Дескриптор загруженного модуля, который реализует программный драйвер (например, D3D10Ref.dll). Чтобы получить дескриптор, вызовите функцию GetModuleHandle .

Флаги [в]

Тип: UINT

Флаги создания устройств (см. перечисление D3D10_CREATE_DEVICE_FLAG ), которые позволяют использовать уровни API. Эти флаги могут быть побитовые OR'd вместе.

ppDevice [out]

Тип: ID3D10Device**

Адрес указателя на созданное устройство (см. интерфейс ID3D10Device ).

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

Тип: HRESULT

Эта функция возвращает один из следующих кодов возврата Direct3D 10.

Эта функция пытается создать лучшее устройство для оборудования. Сначала функция пытается создать устройство версии 10.1. Если не удается создать устройство версии 10.1, функция пытается создать устройство версии 10.0. Если ни то или иное устройство не создано, функция возвращает E_FAIL.

Если приложению необходимо создать только устройство 10.1 или только устройство 10.0, используйте следующие функции:

Используйте функцию D3D10CreateDevice только для создания устройства Direct3D 10.0.
Используйте функцию D3D10CreateDevice1 только для создания устройства Direct3D 10.1.
Используйте функцию D3DX10GetFeatureLevel1 , чтобы получить указатель интерфейса ID3D10Device1 из указателя интерфейса ID3D10Device .

Устройство Direct3D 10.1 можно создать только на компьютерах под управлением Windows Vista с пакетом обновления 1 (SP1) или более поздней версии и с установленным оборудованием, совместимым с Direct3D 10.1. Однако можно вызывать эту функцию на компьютерах под управлением любой версии Windows, на которых установлена библиотека DLL D3DX10.

Требования

Требование	Значение
Заголовок	D3DX10Core.h

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

Функции общего назначения