IWICBitmapFrameEncode：：SetThumbnail 方法 (wincodec.h)
如果編解碼器支援，請設定框架縮圖。
語法
HRESULT SetThumbnail(
[in] IWICBitmapSource *pIThumbnail
);
參數
[in] pIThumbnail
類型： IWICBitmapSource*
要作為縮圖使用的點陣圖來源。
傳回值
類型： HRESULT
如果成功，則傳回S_OK，否則傳回錯誤值。
如果編碼器不支援此功能，則傳回WINCODEC_ERR_UNSUPPORTEDOPERATION。
備註
建議您先呼叫 SetThumbnail ，再呼叫 WritePixels 或 WriteSource。 如果在呼叫 WritePixels 或 WriteSource 之後呼叫 SetThumbnail，則不會將縮圖新增至編碼的檔案。
- BMP、PNG不支援設定縮圖。 此函式會 傳回WINCODEC_ERR_UNSUPPORTEDOPERATION。
- Jpeg支援設定縮圖。 來源影像會重新編碼為 8bpp 或 24bpp JPEG，並寫入 JPEG 的 APP1 元數據區塊。
- Tiff 支援設定縮圖。 來源影像會重新編碼為 TIFF，並寫入框架的 SubIFD 區塊。
- JPEG-XR支援設定縮圖。 來源影像會重新編碼為額外的 8bpp 或 24bpp 框架。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | wincodec.h |
| 程式庫 | Windowscodecs.lib |
| Dll | Windowscodecs.dll |
另請參閱
概念