Direct3DCreate9 函数 (d3d9.h)

创建 IDirect3D9 对象并返回一个接口。

语法

IDirect3D9 * Direct3DCreate9(
  UINT SDKVersion
);

SDKVersion

类型： UINT

应D3D_SDK_VERSION此参数的值。请参阅“备注”。

类型： IDirect3D9*

如果成功，此函数返回指向 IDirect3D9 接口的指针;否则，返回 NULL 指针。

Direct3D 对象是图形应用程序需要创建的第一个 Direct3D COM 对象，也是应用程序需要释放的最后一个对象。枚举和检索设备功能的函数可通过 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) 。