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
| 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 |