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

另請參閱

ID2D1Bitmap