共用方式為

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

另請參閱

IWICImageEncoder

IWICImagingFactory2：：CreateImageEncoder

WICImageParameters