D2D1CreateDevice 函数 (d2d1_1.h)

创建与提供的 DXGI 设备关联的新 Direct2D 设备。

语法

HRESULT D2D1CreateDevice(
  [in]           IDXGIDevice                    *dxgiDevice,
  [in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
  [out]          ID2D1Device                    **d2dDevice
);

参数

[in] dxgiDevice

与 Direct2D 设备关联的 DXGI 设备。

[in, optional] creationProperties

要应用于 Direct2D 设备的属性。

[out] d2dDevice

当此函数返回时,包含指向 Direct2D 设备的指针的地址。

返回值

函数返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

HRESULT 说明
S_OK 未发生错误。
E_OUTOFMEMORY Direct2D 无法分配足够的内存来完成调用。
E_INVALIDARG 传递给方法的值无效。

注解

此函数还将创建可通过 ID2D1Resource::GetFactory 检索的新 ID2D1Factory1

如果未指定创建属性,则 d2dDevice 将从 dxgiDevice 继承其线程模式,并且不会启用调试跟踪。

要求

要求
最低受支持的客户端 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d2d1_1.h
DLL D2d1.dll

另请参阅

D2D1CreateFactory

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory