创建与 DXGI 图面关联的新 Direct2D 设备上下文。
Syntax
HRESULT D2D1CreateDeviceContext(
[in] IDXGISurface *dxgiSurface,
[in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
[out] ID2D1DeviceContext **d2dDeviceContext
);
参数
[in] dxgiSurface
与 Direct2D 设备上下文关联的 DXGI 图面。
[in, optional] creationProperties
要应用于 Direct2D 设备上下文的属性。
[out] d2dDeviceContext
当此函数返回时，包含指向 Direct2D 设备上下文的指针的地址。
返回值
该函数返回 HRESULT。 可能的值包括但不限于下表中的值。
| HRESULT | Description |
|---|---|
| S_OK | 未发生错误。 |
| E_OUTOFMEMORY | Direct2D 无法分配足够的内存来完成调用。 |
| E_INVALIDARG | 向方法传递了无效值。 |
注解
此函数还将创建一个新的 ID2D1Factory1 ，该 ID2D1Factory 可通过 ID2D1Resource：：GetFactory 进行检索。
此函数还将创建可通过 ID2D1DeviceContext：：GetDevice 检索的新 ID2D1Device。
DXGI 设备将通过 dxgiSurface 隐式指定。
如果未指定 creationProperties，Direct2D 设备将从 dxgiSurface 隐含的 DXGI 设备继承其线程模式，并且不会启用调试跟踪。
要求
| 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 |