ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,ID2D1BitmapRenderTarget**)-Methode (d2d1.h)
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 |