Функция Direct3DCreate9 (d3d9.h)
Создайте объект IDirect3D9 и верните ему интерфейс.
Синтаксис
IDirect3D9 * Direct3DCreate9(
UINT SDKVersion
);
Параметры
SDKVersion
Тип: UINT
Значение этого параметра должно быть D3D_SDK_VERSION. См. заметки.
Возвращаемое значение
Тип: IDirect3D9*
В случае успешного выполнения эта функция возвращает указатель на интерфейс IDirect3D9 ; в противном случае возвращается указатель NULL .
Комментарии
Объект Direct3D — это первый COM-объект Direct3D, который необходимо создать графическому приложению, и последний объект, который приложение должно освободить. Функции для перечисления и извлечения возможностей устройства доступны через объект Direct3D. Это позволяет приложениям выбирать устройства без их создания.
Создайте объект IDirect3D9, как показано ниже:
LPDIRECT3D9 g_pD3D = NULL;
if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))
return E_FAIL;
Интерфейс IDirect3D9 поддерживает перечисление активных адаптеров дисплея и позволяет создавать объекты IDirect3DDevice9 . Если пользователь динамически добавляет адаптеры (путем добавления устройств на рабочий стол или путем горячей стыковки ноутбука), эти устройства не будут включены в перечисление. При создании нового интерфейса IDirect3D9 будут представлены новые устройства.
D3D_SDK_VERSION передается в эту функцию, чтобы убедиться, что файлы заголовков, для которых компилируется приложение, соответствуют версии библиотек DLL среды выполнения, установленных на компьютере. D3D_SDK_VERSION изменяется в среде выполнения только в том случае, если для изменения заголовка (или другого изменения кода) потребуется перестроить приложение. Если эта функция завершается сбоем, это означает, что версия файла заголовка не соответствует версии dll среды выполнения.
Пример см. в разделе Создание устройства (Direct3D 9).
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | d3d9.h (включая D3D9.h) |
| Библиотека | D3d9.lib |
| DLL | D3d9.dll |