ID2D1RenderTarget::CreateLayer(D2D1_SIZE_F,ID2D1Layer**)-Methode (d2d1.h)

Erstellt eine Ebenenressource, die mit diesem Renderziel und seinen kompatiblen Renderzielen verwendet werden kann. Die neue Ebene hat die angegebene Anfangsgröße.

Syntax

HRESULT CreateLayer(
  D2D1_SIZE_F size,
  ID2D1Layer  **layer
);

Parameter

size

Typ: [in] D2D1_SIZE_F

Wenn (0, 0) angegeben ist, wird hinter der Layerressource kein Sicherungsspeicher erstellt. Die Layerressource wird der Mindestgröße zugeordnet, wenn PushLayer aufgerufen wird.

layer

Typ: [out] ID2D1Layer**

Wenn die Methode zurückgibt, enthält einen Zeiger auf einen Zeiger auf die neue Ebene. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Unabhängig davon, ob zunächst eine Größe angegeben wird, ändert sich die Größe der Ebene automatisch nach Bedarf.

Beispiele

Ein Beispiel zur Verwendung von CreateLayer finden Sie im Thema Ausschneiden eines Bereichs mit einem Layer .

Anforderungen

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

Weitere Informationen

ID2D1RenderTarget

Übersicht über Ebenen