D2D1CreateDeviceContext 函数 (d2d1_1.h)
创建与 DXGI 图面关联的新 Direct2D 设备上下文。
语法
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 | 说明 |
|---|---|
| S_OK | 未发生错误。 |
| E_OUTOFMEMORY | Direct2D 无法分配足够的内存来完成调用。 |
| E_INVALIDARG | 传递给方法的值无效。 |
注解
此函数还将创建可通过 ID2D1Resource：：GetFactory 检索的新 ID2D1Factory1。
此函数还将创建可通过 ID2D1DeviceContext：：GetDevice 检索的新 ID2D1Device。
DXGI 设备将通过 dxgiSurface 隐式指定。
如果未指定 creationProperties ，则 Direct2D 设备将从 dxgiSurface 隐含的 DXGI 设备继承其线程模式，并且不会启用调试跟踪。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | d2d1_1.h |
| DLL | D2d1.dll |