ID2D1Bitmap::CopyFromMemory-Methode (d2d1.h)

Kopiert den angegebenen Bereich aus dem Arbeitsspeicher in die aktuelle Bitmap.

Syntax

HRESULT CopyFromMemory(
  [in, optional] const D2D1_RECT_U *dstRect,
  [in]           const void        *srcData,
                 UINT32            pitch
);

Parameter

[in, optional] dstRect

Typ: const D2D1_RECT_U*

In der aktuellen Bitmap das Rechteck, in das der durch srcRect angegebene Bereich kopiert wird.

[in] srcData

Typ: const void*

Die zu kopierenden Daten.

pitch

Typ: UINT32

Die Schritt- oder Tonhöhe der quell-Bitmap, die in srcData gespeichert ist. Der Schritt ist die Byteanzahl einer Scanlinie (eine Zeile mit Pixeln im Arbeitsspeicher). Der Schritt kann anhand der folgenden Formel berechnet werden: Pixelbreite * Bytes pro Pixel + Speicherabstand.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Mit dieser Methode wird die Größe der aktuellen Bitmap nicht aktualisiert. Wenn der Inhalt der Quellbit nicht in die aktuelle Bitmap passt, schlägt diese Methode fehl. Beachten Sie außerdem, dass diese Methode keine Formatkonvertierung durchführt. Die beiden Bitmapformate sollten übereinstimmen.

Wenn diese Methode ungültige Eingaben (z. B. ein ungültiges Zielrechteck) übergeben wird, kann unvorhersehbare Ergebnisse wie ein verzerrtes Bild oder gerätefehler führen.

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 Fehlerzustand des Renderziels, auf dem 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 komprimierte Bitmaps mit Block. Wenn Sie ein komprimiertes Blockformat 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