ID2D1Factory::CreateDrawingStateBlock method

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

Syntax


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

Parameters

drawingStateDescription [in, optional]

Type: const D2D1_DRAWING_STATE_DESCRIPTION*

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

textRenderingParams [in, optional]

Type: IDWriteRenderingParams*

Optional text parameters that indicate how text should be rendered.

drawingStateBlock [out]

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

Minimum supported client

Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Header

D2d1.h

Library

D2d1.lib

DLL

D2d1.dll

See also

ID2D1Factory

 

 

Show: