共用方式為


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