Metode IWICBitmapFrameEncode::SetThumbnail (wincodec.h)

Mengatur gambar mini bingkai jika didukung oleh codec.

Sintaks

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

Parameter

[in] pIThumbnail

Jenis: IWICBitmapSource*

Sumber bitmap yang digunakan sebagai gambar mini.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya.

Mengembalikan WINCODEC_ERR_UNSUPPORTEDOPERATION jika fitur tidak didukung oleh encoder.

Keterangan

Kami menyarankan agar Anda memanggil SetThumbnail sebelum memanggil WritePixels atau WriteSource. Gambar mini tidak akan ditambahkan ke file yang dikodekan jika SetThumbnail dipanggil setelah panggilan ke WritePixels atau WriteSource.

• BMP, PNGThumbnail pengaturan tidak didukung. Fungsi ini akan mengembalikan WINCODEC_ERR_UNSUPPORTEDOPERATION.
• JPEGMengatur gambar mini didukung. Gambar sumber akan dikodekan ulang sebagai JPEG 8bpp atau 24bpp dan akan ditulis ke blok metadata APP1 JPEG.
• TIFF Mengatur gambar mini didukung. Gambar sumber akan dikodekan ulang sebagai TIFF dan akan ditulis ke blok SubIFD bingkai.
• JPEG-XRMengatur gambar mini didukung. Gambar sumber akan dikodekan ulang sebagai bingkai 8bpp atau 24bpp tambahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	wincodec.h
Pustaka	Windowscodecs.lib
DLL	Windowscodecs.dll

Lihat juga

Konseptual

Gambaran Umum Pengodean

Cara Menulis WIC-Enabled CODEC

IWICBitmapFrameEncode