ID2D1Factory1::CreateDrawingStateBlock(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.


HRESULT CreateDrawingStateBlock(
  [out] ID2D1DrawingStateBlock1 **drawingStateBlock


[out] drawingStateBlock

Type: ID2D1DrawingStateBlock1**

The address of the newly created drawing state block.

Return value


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.


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