Metode ITranscodeImage::TranscodeImage (imagetranscode.h)

Mengonversi gambar ke format gambar JPEG atau bitmap (BMP).

Sintaks

HRESULT TranscodeImage(
  [in]            IShellItem *pShellItem,
                  UINT       uiMaxWidth,
                  UINT       uiMaxHeight,
                  DWORD      flags,
                  IStream    *pvImage,
  [out, optional] UINT       *puiWidth,
  [out, optional] UINT       *puiHeight
);

Parameter

[in] pShellItem

Jenis: IShellItem*

Item Shell untuk dikonversi gambar.

uiMaxWidth

Jenis: UINT

Tinggi yang diminta dalam piksel. Harus kurang dari atau sama dengan tinggi sebenarnya dari gambar asli. Lihat Keterangan.

uiMaxHeight

Jenis: UINT

Lebar yang diminta dalam piksel. Harus kurang dari atau sama dengan lebar sebenarnya dari gambar asli. Lihat Keterangan.

flags

Jenis: TI_FLAGS

Salah satu bendera berikut.

TI_BITMAP

Mengonversi gambar ke format BMP.

TI_JPEG

Konversikan gambar ke format JPEG.

pvImage

Jenis: IStream*

Aliran untuk menerima gambar yang dikonversi. Aliran harus dibuat oleh kode panggilan sebelum memanggil TranscodeImage.

[out, optional] puiWidth

Jenis: UINT*

Lebar aktual dari gambar yang dikonversi.

[out, optional] puiHeight

Jenis: UINT*

Tinggi sebenarnya dari gambar yang dikonversi.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Rasio aspek gambar asli dipertahankan. Gambar baru diubah ukurannya sehingga akan masuk ke dalam kotak lebar uiMaxWidth dan uiMaxHeight tinggi.

Ukuran gambar tidak akan diubah jika gambar asli sudah pas dalam kotak pembatas ini.

Jika uiMaxWidth dan uiMaxHeight nol, gambar yang dikembalikan akan berukuran sama dengan aslinya.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	imagetranscode.h