Функция Direct3DCreate9 (d3d9helper.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 | d3d9helper.h (включая D3D9.h) |
| Библиотека | D3d9.lib |
| DLL | D3d9.dll |