ITranscodeImage：：TranscodeImage 方法 (imagetranscode.h)

將影像轉換成 JPEG 或點陣圖 (BMP) 影像格式。

語法

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

參數

[in] pShellItem

類型： IShellItem*

要轉換之影像的殼層專案。

uiMaxWidth

類型： UINT

要求的高度，以圖元為單位。 應小於或等於原始影像的實際高度。 請參閱＜備註＞。

uiMaxHeight

類型： UINT

要求的寬度，以圖元為單位。 應小於或等於原始影像的實際寬度。 請參閱＜備註＞。

flags

類型： TI_FLAGS

下列其中一個旗標。

TI_BITMAP

將影像轉換成 BMP 格式。

TI_JPEG

將影像轉換成 JPEG 格式。

pvImage

類型： IStream*

要接收已轉換影像的資料流程。 呼叫 TranscodeImage之前，呼叫程式碼必須建立資料流程。

[out, optional] puiWidth

類型： UINT*

已轉換影像的實際寬度。

[out, optional] puiHeight

類型： UINT*

已轉換影像的實際高度。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

保留原始影像的外觀比例。 新的影像會調整大小，使其符合 寬度 uiMaxWidth 和 height uiMaxHeight的方塊。

如果原始影像已符合此周框方塊，則不會變更影像大小。

如果 uiMaxWidth 和 uiMaxHeight 都是零，則傳回的影像大小會與原始影像相同。

需求