ID2D1Factory1::CreateDrawingStateBlock (constD2D1_DRAWING_STATE_DESCRIPTION1*,IDWriteRenderingParams*,ID2D1DrawingStateBlock1**) 方法 (d2d1_1.h)

创建一个新的绘图状态块,这可用于对呈现目标执行的后续 SaveDrawingState 和 RestoreDrawingState 操作。

语法

HRESULT CreateDrawingStateBlock(
  [in, optional] const D2D1_DRAWING_STATE_DESCRIPTION1 *drawingStateDescription,
  [in, optional] IDWriteRenderingParams                *textRenderingParams,
  [out]          ID2D1DrawingStateBlock1               **drawingStateBlock
);

参数

[in, optional] drawingStateDescription

类型: const D2D1_DRAWING_STATE_DESCRIPTION1*

绘图状态说明结构。

[in, optional] textRenderingParams

类型: IDWriteRenderingParams*

呈现参数接口DirectWrite。

[out] drawingStateBlock

类型: ID2D1DrawingStateBlock1**

新建的绘图状态块的地址。

返回值

类型: HRESULT

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

HRESULT 说明
S_OK 未发生错误。
E_OUTOFMEMORY Direct2D 无法分配足够的内存来完成调用。
E_INVALIDARG 传递给方法的值无效。

要求

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

另请参阅

ID2D1Factory1