IWICImageEncoder::WriteThumbnail 方法 (wincodec.h)
將指定的影像編碼為指定 WIC 點陣圖編碼器的縮圖。
語法
HRESULT WriteThumbnail(
[in] ID2D1Image *pImage,
[in] IWICBitmapEncoder *pEncoder,
[in] const WICImageParameters *pImageParameters
);
參數
[in] pImage
類型: ID2D1Image*
將編碼的 Direct2D 影像。
[in] pEncoder
類型: IWICBitmapEncoder*
設定縮圖的編碼器。
[in] pImageParameters
類型:const WICImageParameters*
用來控制編碼的其他參數。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
您必須在與 IWICImagingFactory2::CreateImageEncoder相同的裝置上建立您傳入的映射。 如果您未在 pImageParameters 指向的變數中指定其他參數,編碼器會使用一組有用的預設值。 如需這些預設值的相關資訊,請參閱 WICImageParameters。
呼叫 WriteThumbnail之前,您必須為您要設定縮圖的編碼器設定 IWICBitmapEncoder 介面。
如果 WriteThumbnail 失敗,它可能會從編碼器傳回E_OUTOFMEMORY、D2DERR_WRONG_RESOURCE_DOMAIN或其他錯誤碼。
規格需求
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | wincodec.h |
程式庫 | Windowscodecs.lib |
Dll | Windowscodecs.dll |