ID2D1Bitmap::CopyFromRenderTarget-Methode (d2d1.h)
Kopiert den angegebenen Bereich aus dem angegebenen Renderziel in die aktuelle Bitmap.
Syntax
HRESULT CopyFromRenderTarget(
[in, optional] const D2D1_POINT_2U *destPoint,
[in] ID2D1RenderTarget *renderTarget,
[in, optional] const D2D1_RECT_U *srcRect
);
Parameter
[in, optional] destPoint
Typ: const D2D1_POINT_2U*
In der aktuellen Bitmap die obere linke Ecke des Bereichs, in den der durch srcRect angegebene Bereich kopiert wird.
[in] renderTarget
Typ: ID2D1RenderTarget*
Das Renderziel, das die zu kopierende Region enthält.
[in, optional] srcRect
Typ: const D2D1_RECT_U*
Der zu kopierende Bereich von renderTarget .
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Diese Methode aktualisiert die Größe der aktuellen Bitmap nicht. Wenn der Inhalt der Quell-Bitmap nicht in die aktuelle Bitmap passt, schlägt diese Methode fehl. Beachten Sie außerdem, dass diese Methode keine Formatkonvertierung durchführt und fehlschlägt, wenn die Bitmapformate nicht übereinstimmen.
Das Aufrufen dieser Methode kann dazu führen, dass der aktuelle Batch geleert wird, wenn die Bitmap im Batch aktiv ist. Wenn der Batch, der geleert wurde, nicht erfolgreich abgeschlossen wird, schlägt diese Methode fehl. Diese Methode löscht jedoch nicht den Fehlerstatus des Renderziels, für das der Batch geleert wurde. Der fehlerhafte HRESULT - und Tagzustand wird beim nächsten Aufruf von EndDraw oder Flush zurückgegeben.
Alle Clips und Ebenen müssen vom Renderziel entfernt werden, bevor diese Methode aufgerufen wird. Die Methode gibt D2DERR_RENDER_TARGET_HAS_LAYER_OR_CLIPRECT zurück, wenn derzeit Clips oder Ebenen auf das Renderziel angewendet werden.
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 |