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 と高さ uiMaxHeight のボックスに収まるように、新しいイメージのサイズが変更されます。

元のイメージがこの境界ボックスに既に収まっている場合、イメージ のサイズは変更されません。

uiMaxWidth と uiMaxHeight の両方が 0 の場合、返されるイメージは元のイメージと同じサイズになります。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	imagetranscode.h