D3D10CreateDevice1 函数 (d3d10_1.h)

创建表示显示适配器的 Direct3D 10.1 设备。

语法

HRESULT D3D10CreateDevice1(
  [in]  IDXGIAdapter         *pAdapter,
  [in]  D3D10_DRIVER_TYPE    DriverType,
  [in]  HMODULE              Software,
  [in]  UINT                 Flags,
  [in]  D3D10_FEATURE_LEVEL1 HardwareLevel,
  [in]  UINT                 SDKVersion,
  [out] ID3D10Device1        **ppDevice
);

参数

[in] pAdapter

类型: IDXGIAdapter*

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

[in] DriverType

类型: D3D10_DRIVER_TYPE

设备驱动程序类型 (请参阅 D3D10_DRIVER_TYPE) 。 驱动程序类型确定要创建的设备类型。

[in] Software

类型: HMODULE

除D3D10_DRIVER_TYPE_SOFTWARE驱动程序类型外,此值设置为 NULL

[in] Flags

类型: UINT

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

[in] HardwareLevel

类型: D3D10_FEATURE_LEVEL1

可用于加速的硬件版本 (请参阅 D3D10_FEATURE_LEVEL1) 。

[in] SDKVersion

类型: UINT

指示 SDK 版本的位标志。 应D3D10_1_SDK_VERSION,在 D3D10.h 中定义。

[out] ppDevice

类型: ID3D10Device1**

指向创建的设备的指针的地址 (请参阅 ID3D10Device1 接口) 。

返回值

类型: HRESULT

此方法返回以下 Direct3D 10 返回代码之一。

注解

若要同时创建设备和交换链,请参阅 D3D10CreateDeviceAndSwapChain1

此方法需要 Windows Vista Service Pack 1、Windows Server 2008 或更高版本的 Windows。

D3D10CreateDevice1 返回的对象实现 IUnknown 接口,并且可以查询该对象支持的其他接口。 若要检索 对象的 IDXGIDevice 接口,可以使用以下代码。


IDXGIDevice * pDXGIDevice;
hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);
      

要求

   
目标平台 Windows
标头 d3d10_1.h
Library D3D10_1.lib
DLL D3D10_1.dll

另请参阅

核心函数