Метод 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 равны нулю, возвращенное изображение будет иметь тот же размер, что и исходное.

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	imagetranscode.h