ID2D1Bitmap::CopyFromBitmap-Methode (d2d1.h)

Kopiert den angegebenen Bereich aus der angegebenen Bitmap in die aktuelle Bitmap.

Syntax

HRESULT CopyFromBitmap(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1Bitmap         *bitmap,
  [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] bitmap

Typ: ID2D1Bitmap*

Die Bitmap, aus der kopiert werden soll.

[in, optional] srcRect

Typ: const D2D1_RECT_U*

Der Bereich der zu kopierenden Bitmap .

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.

Ab Windows 8.1 unterstützt diese Methode blockkomprimierte Bitmaps. Wenn Sie ein blockkomprimiertes Format verwenden, müssen die Endkoordinaten des srcRect-Parameters ein Vielfaches von 4 sein, oder die Methode gibt E_INVALIDARG zurück.

Anforderungen

Weitere Informationen

ID2D1Bitmap