IWICBitmapEncoder_Commit

画像に対するすべての変更をコミットしてストリームを閉じる。

IWICBitmapEncoder_Commit this

this : [comobj] IWICBitmapEncoder インターフェースの COM オブジェクト変数

(プラグイン / モジュール : com_misc.dll)

解説

画像に対するすべての変更をコミットしてストリームを閉じる。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。失敗した場合は HRESULT エラーコードを返す。

[備考]
画像を確定するには、フレームの Commit とエンコーダの Commit の両方を呼び出す必要がある。ただしエンコーダの Commit
メソッドはすべてのフレームがコミットされた後にのみ呼び出すこと。エンコーダがコミットされた後は、再初期化したり別のストリームで再利用したりすることはできない。たとえば
IWICImagingFactory::CreateEncoder などで新しいエンコーダインターフェースを生成する必要がある。
エンコーダの Commit が成功するためには、少なくとも IWICBitmapEncoder::Initialize を呼び、さらに
IWICBitmapFrameEncode::WriteSource か
IWICBitmapFrameEncode::WritePixels のいずれかを呼ばなければならない。
IWICBitmapFrameEncode::WriteSource
は画像データのエンコードに必要なすべてのパラメータを指定する。IWICBitmapFrameEncode::WritePixels
を使用する場合は、IWICBitmapFrameEncode::SetSize、IWICBitmapFrameEncode::SetPixelFormat、および
(ピクセルフォーマットがインデックスの場合) IWICBitmapFrameEncode::SetPalette も呼び出す必要がある。

情報