ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,ID2D1BitmapRenderTarget**)-Methode (d2d1.h)

  • Artikel

Erstellt ein Bitmaprenderungsziel für die Verwendung bei zwischengeschalteter Offscreen-Zeichnung, das mit dem aktuellen Renderziel kompatibel ist.

Syntax

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

Parameter

desiredSize

Typ: [in] D2D1_SIZE_F

Die gewünschte Größe des neuen Renderziels (in geräteunabhängigen Pixeln), wenn es sich vom ursprünglichen Renderziel unterscheiden soll. Weitere Informationen finden Sie im Abschnitt Hinweise.

desiredPixelSize

Typ: [in] D2D1_SIZE_U

Die gewünschte Größe des neuen Renderziels in Pixel, wenn es sich vom ursprünglichen Renderziel unterscheiden soll. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

bitmapRenderTarget

Typ: [out] ID2D1BitmapRenderTarget**

Wenn diese Methode zurückgibt, enthält einen Zeiger auf einen Zeiger auf ein neues Bitmaprenderingziel. 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

Die Pixelgröße und dpi des neuen Renderziels können durch Angabe von Werten für desiredSize oder desiredPixelSize geändert werden.

  • Wenn desiredSize angegeben ist, desiredPixelSize jedoch nicht, wird die Pixelgröße aus der gewünschten Größe mit der übergeordneten Ziel-DPI berechnet. Wenn desiredSize einer ganzzahligen Pixelgröße zugeordnet ist, entspricht der DPI-Wert des kompatiblen Renderziels dem DPI-Wert des übergeordneten Ziels. Wenn desiredSize einer Pixelbruchgröße zugeordnet ist, wird die Pixelgröße auf die nächste ganze Zahl aufgerundet, und der DPI-Wert für das kompatible Renderziel ist etwas höher als der DPI-Wert des übergeordneten Renderziels. In allen Fällen wird die Koordinate (desiredSize.width, desiredSize.height) der unteren rechten Ecke des kompatiblen Renderziels zugeordnet.
  • Wenn desiredPixelSize und desiredSize nicht angegeben ist, entspricht der DPI-Wert des neuen Renderziels dem ursprünglichen Renderziel.
  • Wenn sowohl desiredSize als auch desiredPixelSize angegeben sind, wird der DPI-Wert des neuen Renderziels berechnet, um den Skalierungsunterschied zu berücksichtigen.
  • Wenn weder desiredSize noch desiredPixelSize angegeben ist, stimmen die neue Renderzielgröße und DPI mit dem ursprünglichen Renderziel überein.

Das mit dieser Methode erstellte Bitmaprenderungsziel ist nicht mit GDI kompatibel.

Anforderungen

Anforderung Wert
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