Share via


ID2D1Factory1::CreateDrawingStateBlock(constD2D1_DRAWING_STATE_DESCRIPTION1*,IDWriteRenderingParams*,ID2D1DrawingStateBlock1**)-Methode (d2d1_1.h)

Erstellt einen neuen Zeichnungszustandsblock. Dieser kann in nachfolgenden SaveDrawingState- und RestoreDrawingState-Vorgängen auf dem Renderziel verwendet werden.

Syntax

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

Parameter

[in, optional] drawingStateDescription

Typ: const D2D1_DRAWING_STATE_DESCRIPTION1*

Die Zeichnungszustandsbeschreibungsstruktur.

[in, optional] textRenderingParams

Typ: IDWriteRenderingParams*

Die DirectWrite Renderingparameterschnittstelle.

[out] drawingStateBlock

Typ: ID2D1DrawingStateBlock1**

Die Adresse des neu erstellten Zeichnungszustandsblocks.

Rückgabewert

Typ: HRESULT

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

HRESULT BESCHREIBUNG
S_OK Kein Fehler ist aufgetreten.
E_OUTOFMEMORY Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen.
E_INVALIDARG Ein ungültiger Wert wurde an die -Methode übergeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1_1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1Factory1