ID2D1Factory1::CreateDrawingStateBlock(constD2D1_DRAWING_STATE_DESCRIPTION1&,ID2D1DrawingStateBlock1**)-Methode (d2d1_1.h)
Erstellt einen neuen Zeichnungszustandsblock, der in nachfolgenden SaveDrawingState- und RestoreDrawingState-Vorgängen für das Renderziel verwendet werden kann.
Syntax
HRESULT CreateDrawingStateBlock(
[in, ref, optional] const D2D1_DRAWING_STATE_DESCRIPTION1 & drawingStateDescription,
[out] ID2D1DrawingStateBlock1 **drawingStateBlock
);
Parameter
[in, ref, optional] drawingStateDescription
Typ: const D2D1_DRAWING_STATE_DESCRIPTION1
Die Zeichnungszustandsbeschreibungsstruktur.
[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 Aufruf 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 |