ID2D1Factory1::CreateDrawingStateBlock(constD2D1_DRAWING_STATE_DESCRIPTION1&,ID2D1DrawingStateBlock1**) method (d2d1_1.h)

Creates a new drawing state block, this can be used in subsequent SaveDrawingState and RestoreDrawingState operations on the render target.

Syntax

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

Parameters

[in, ref, optional] drawingStateDescription

Type: const D2D1_DRAWING_STATE_DESCRIPTION1

The drawing state description structure.

[out] drawingStateBlock

Type: ID2D1DrawingStateBlock1**

The address of the newly created drawing state block.

Return value

Type: HRESULT

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULT Description
S_OK No error occurred.
E_OUTOFMEMORY Direct2D could not allocate sufficient memory to complete the call.
E_INVALIDARG An invalid value was passed to the method.

Requirements

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1_1.h
Library D2d1.lib
DLL D2d1.dll

See also

ID2D1Factory1