D2D1CreateDeviceContext 函数 (d2d1_1.h)

项目
03/05/2024

创建与 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