ID2D1Bitmap：：CopyFromMemory 方法 (d2d1.h)
將指定的區域從記憶體複製到目前的點陣圖。
語法
HRESULT CopyFromMemory(
[in, optional] const D2D1_RECT_U *dstRect,
[in] const void *srcData,
UINT32 pitch
);
參數
[in, optional] dstRect
類型： const D2D1_RECT_U*
在目前的點陣圖中，會複製 srcRect 所指定區域的矩形。
[in] srcData
類型： const void*
要複製的資料。
pitch
類型： UINT32
儲存在 srcData 中來源位圖的步調或音調。 跨度是掃描線的位元組計數， (記憶體中的一列圖元) 。 您可以從下列公式計算步幅：像素寬度 * 每個像素的位元組 + 記憶體填補。
傳回值
類型： HRESULT
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
這個方法不會更新目前點陣圖的大小。 如果來源位圖的內容不符合目前的點陣圖，這個方法就會失敗。 另請注意，這個方法不會執行格式轉換;這兩個點陣圖格式應該相符。
如果此方法傳遞無效的輸入 (例如無效的目的地矩形) ，可能會產生無法預期的結果，例如扭曲的影像或裝置失敗。
如果點圖在批次中使用中，呼叫這個方法可能會導致目前的批次排清。 如果排清的批次未順利完成，這個方法就會失敗。 不過，這個方法不會清除批次排清所在轉譯目標的錯誤狀態。 失敗 的 HRESULT 和標記狀態會在下一次 呼叫 EndDraw 或 Flush 時傳回。
從 Windows 8.1 開始，這個方法支援區塊壓縮位圖。 如果您使用區塊壓縮格式， srcRect 參數的結束座標必須是 4 的倍數，否則方法會 傳回E_INVALIDARG。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | d2d1.h |
| 程式庫 | D2d1.lib |
| Dll | D2d1.dll |