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
);

parameters

pAdapter [in]

类型： IDXGIAdapter*

指向显示适配器的指针 (在创建硬件设备时看到 IDXGIAdapter 接口) ;否则，请将此参数设置为 NULL。 如果在创建硬件设备时指定 NULL ，则 Direct3D 将使用 IDXGIFactory 接口枚举的第一个适配器。

DriverType [in]

类型： D3D10_DRIVER_TYPE

设备驱动程序类型 (查看 D3D10_DRIVER_TYPE 枚举) 。 驱动程序类型确定要创建的设备类型。

软件 [in]

类型： HMODULE

实现软件驱动程序 (（如D3D10Ref.dll) ）的已加载模块的句柄。 若要获取句柄，请调用 GetModuleHandle 函数。

Flags [in]

类型： UINT

设备创建标志 (查看启用 API 层的D3D10_CREATE_DEVICE_FLAG枚举) 。 这些标志可以按位 OR 组合在一起。

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 函数从 ID3D10Device 接口指针获取 ID3D10Device1 接口指针。

只能在运行 Windows Vista Service Pack 1 或更高版本且安装了与 Direct3D 10.1 兼容的硬件的计算机上创建 Direct3D 10.1 设备。 但是，在运行安装了 D3DX10 DLL 的任何版本的 Windows 的计算机上调用此函数是合法的。

要求

要求	值
标头	D3DX10Core.h

请参阅

常规用途函数