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 枚举) 。 驱动程序类型确定要创建的设备类型。
-
软件 [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 的计算机上调用此函数是合法的。
要求
要求 | 值 |
---|---|
标头 |
|
请参阅