ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,D2D1_PIXEL_FORMAT,D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS,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,
D2D1_PIXEL_FORMAT desiredFormat,
D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
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.
desiredFormat
Typ: [in] D2D1_PIXEL_FORMAT
Das gewünschte Pixelformat und der Alphamodus des neuen Renderziels. Wenn das Pixelformat auf DXGI_FORMAT_UNKNOWN festgelegt ist, verwendet das neue Renderziel das gleiche Pixelformat wie das ursprüngliche Renderziel. Wenn der Alphamodus D2D1_ALPHA_MODE_UNKNOWN ist, wird der Alphamodus des neuen Renderziels standardmäßig auf D2D1_ALPHA_MODE_PREMULTIPLIED festgelegt. Informationen zu unterstützten Pixelformaten finden Sie unter Unterstützte Pixelformate und Alphamodi.
options
Typ: [in] D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS
Ein -Wert, der angibt, ob das neue Renderziel mit GDI kompatibel sein muss.
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.
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für