ID2D1Factory::CreateDrawingStateBlock(constD2D1_DRAWING_STATE_DESCRIPTION*,IDWriteRenderingParams*,ID2D1DrawingStateBlock**) method (d2d1.h)

Creates an ID2D1DrawingStateBlock that can be used with the SaveDrawingState and RestoreDrawingState methods of a render target.

Syntax

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

Parameters

[in, optional] drawingStateDescription

Type: const D2D1_DRAWING_STATE_DESCRIPTION*

A structure that contains antialiasing, transform, and tags information.

[in, optional] textRenderingParams

Type: IDWriteRenderingParams*

Optional text parameters that indicate how text should be rendered.

[out] drawingStateBlock

Type: ID2D1DrawingStateBlock**

When this method returns, contains the address of a pointer to the new drawing state block created by this method.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1.h
Library D2d1.lib
DLL D2d1.dll

See also

ID2D1Factory