Функция D3DX10CreateDevice
Создайте лучшее устройство 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.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
См. также раздел