ID2D1RenderTarget::CreateLayer (D2D1_SIZE_F,ID2D1Layer**) 方法 (d2d1.h)

创建可与此呈现目标及其兼容的呈现目标一起使用的层资源。 新层具有指定的初始大小。

语法

HRESULT CreateLayer(
  D2D1_SIZE_F size,
  ID2D1Layer  **layer
);

参数

size

类型:[in] D2D1_SIZE_F

如果指定 (0, 0) ,则不会在层资源后面创建任何后备存储。 调用 PushLayer 时,层资源将分配到最小大小。

layer

类型:[out] ID2D1Layer**

方法返回时,包含指向指向新层的指针的指针。 此参数未经初始化即被传递。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

备注

无论最初是否指定了大小,层都会根据需要自动调整大小。

示例

有关如何使用 CreateLayer 的示例,请参阅 如何使用图层剪裁区域 主题。

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d2d1.h
Library D2d1.lib
DLL D2d1.dll

另请参阅

ID2D1RenderTarget

层概述