IWICBitmapSource：：CopyPixels 方法 (wincodec.h)

指示 物件產生圖元。

語法

HRESULT CopyPixels(
  [in]  const WICRect *prc,
  [in]  UINT          cbStride,
  [in]  UINT          cbBufferSize,
  [out] BYTE          *pbBuffer
);

參數

[in] prc

類型：const WICRect*

要複製的矩形。 Null值會指定整個點陣圖。

[in] cbStride

類型： UINT

點陣圖的步幅

[in] cbBufferSize

類型： UINT

緩衝區的大小。

[out] pbBuffer

類型： BYTE*

緩衝區的指標。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

CopyPixels 是兩個主要影像處理常式之一， (另一個是 鎖定) 觸發實際處理。 它會指示物件根據其演算法產生圖元-這可能牽涉到解碼儲存在磁片上的一部分 JPEG、複製記憶體區塊，或甚至以分析方式計算複雜的漸層。 演算法完全相依于實作 介面的物件。

呼叫端可以使用中國參數，將作業限制為感興趣的矩形 (ROI) 。 ROI 子矩形必須完全包含在點陣圖的界限中。 指定 Null ROI 表示應該傳回整個點陣圖。

呼叫端會控制記憶體管理，而且必須提供輸出緩衝區 (pbBuffer) ，以取得複本的結果以及緩衝區 (cbBufferSize) 。 cbStride 參數會定義輸出緩衝區中兩個垂直相鄰圖元之間的位元組計數。 呼叫端必須確定有足夠的緩衝區，才能根據點陣圖的寬度、高度和像素格式，以及提供給複製方法的子矩形來完成呼叫。

如果呼叫端需要執行許多昂貴的 IWICBitmapSource 複本，例如 JPEG，建議您先建立記憶體內部 IWICBitmap 。

編解碼器開發人員備註

在此案例中，被呼叫者只能寫入第一 (中國- > Width*bitsperpixel+7) /8 個位元組的輸出緩衝區每一行 (，行是 cbStride 位元組的連續字串) 。

規格需求

最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	wincodec.h
程式庫	Windowscodecs.lib
Dll	Windowscodecs.dll