创建与提供的 DXGI 设备关联的新 Direct2D 设备。
Syntax
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 | Description |
|---|---|
| S_OK | 未发生错误。 |
| E_OUTOFMEMORY | Direct2D 无法分配足够的内存来完成调用。 |
| E_INVALIDARG | 向方法传递了无效值。 |
注解
此函数还将创建一个新的 ID2D1Factory1 ,该 ID2D1Factory 可通过 ID2D1Resource::GetFactory 进行检索。
如果未指定创建属性, 则 d2dDevice 将从 dxgiDevice 继承其线程模式,并且不会启用调试跟踪。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | 适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用] |
| 支持的最低服务器 | 适用于 Windows Server 2008 R2 的 Windows Server 2012 和平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows操作系统 |
| Header | d2d1_1.h |
| Library | d2d1.lib |
| DLL | D2d1.dll |