IWICImageEncoder::WriteThumbnail メソッド (wincodec.h)
指定したイメージを、指定された WIC ビットマップ エンコーダーのサムネイルとしてエンコードします。
構文
HRESULT WriteThumbnail(
[in] ID2D1Image *pImage,
[in] IWICBitmapEncoder *pEncoder,
[in] const WICImageParameters *pImageParameters
);
パラメーター
[in] pImage
種類: ID2D1Image*
エンコードされる Direct2D イメージ。
[in] pEncoder
種類: IWICBitmapEncoder*
サムネイルが設定されているエンコーダー。
[in] pImageParameters
種類: const WICImageParameters*
エンコードを制御するための追加のパラメーター。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
解説
IWICImagingFactory2::CreateImageEncoder と同じデバイスで渡すイメージを作成する必要があります。 pImageParameters が指す変数に追加のパラメーターを指定しない場合、エンコーダーでは便利な既定値のセットが使用されます。 これらの既定値の詳細については、「 WICImageParameters」を参照してください。
WriteThumbnail を呼び出す前に、サムネイルを設定するエンコーダーの IWICBitmapEncoder インターフェイスを設定する必要があります。
WriteThumbnail が失敗した場合は、エンコーダーからE_OUTOFMEMORY、D2DERR_WRONG_RESOURCE_DOMAIN、またはその他のエラー コードが返されることがあります。
要件
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wincodec.h |
| Library | Windowscodecs.lib |
| [DLL] | Windowscodecs.dll |