IWICBitmapFrameEncode：：WriteSource 方法 (wincodec.h)

編碼點陣圖來源。

語法

HRESULT WriteSource(
  [in] IWICBitmapSource *pIBitmapSource,
  [in] WICRect          *prc
);

[in] pIBitmapSource

要編碼的點陣圖來源。

[in] prc

類型： WICRect*

點陣圖來源的大小矩形。

類型： HRESULT

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

如果在呼叫WriteSource之前未呼叫SetSize，則如果不是Null，則會使用中國提供的大小。否則，會使用pIBitmapSource中指定的IWICBitmapSource大小。

如果在呼叫WriteSource之前未呼叫SetPixelFormat，則會使用pIBitmapSource中提供的IWICBitmapSource像素格式。

如果在呼叫WriteSource之前未呼叫SetResolution，則會使用pIBitmapSource的像素格式。

如果在呼叫WriteSource之前未呼叫SetPalette，則會編制目標像素格式的索引，而pIBitmapSource的像素格式符合編碼器框架的像素格式，則會使用pIBitmapSource像素格式。

編碼 GIF 影像時，如果已設定全域調色盤，而且畫面層級調色盤不是由使用者直接設定，或是由自訂獨立軟體廠商 (ISV) GIF 編解碼器， 則 WriteSource 會使用全域調色盤來編碼框架，即使 pIBitmapSource 有畫面層級調色盤也一樣。

從 Windows Vista 開始，只要累積的來源高度總計與透過 SetSize設定相同，就可以進行重複的 WriteSource呼叫。

從Windows 8.1開始，來源 rect 至少必須是透過SetSize設定的維度。如果來源直方寬度超過 SetSize 寬度，則會忽略右側的額外圖元。如果來源 Rect 高度超過剩余未填滿的高度，則會忽略底部的額外掃描行。


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

概念