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 |