ID2D1Bitmap::CopyFromRenderTarget-Methode (d2d1.h)

  • Artikel

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

Weitere Informationen

ID2D1Bitmap