IWICBitmapEncoder::Commit メソッド (wincodec.h)

イメージのすべての変更をコミットし、ストリームを閉じます。

構文

HRESULT Commit();

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

イメージをファイナライズするには、フレーム Commitとエンコーダー Commit の両方を呼び出す必要があります。ただし、すべてのフレームがコミットされた後にのみ、エンコーダー の Commit メソッドを呼び出します。

エンコーダーがコミットされた後は、再初期化したり、別のストリームで再利用したりすることはできません。たとえば、 IWICImagingFactory::CreateEncoder を使用して、新しいエンコーダーインターフェイスを作成する必要があります。

エンコーダー のコミット が成功するには、少なくとも IWICBitmapEncoder::Initialize を呼び出し、 IWICBitmapFrameEncode::WriteSource または IWICBitmapFrameEncode::WritePixels を呼び出す必要があります。

IWICBitmapFrameEncode::WriteSource は、イメージデータのエンコードに必要なすべてのパラメーターを指定します。 IWICBitmapFrameEncode::WritePixels では、 IWICBitmapFrameEncode::SetSize、 IWICBitmapFrameEncode::SetPixelFormat、 IWICBitmapFrameEncode::SetPalette も呼び出す必要があります (ピクセル形式にインデックスが付いている場合)。

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2、Windows Vista [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	wincodec.h
Library	Windowscodecs.lib
[DLL]	Windowscodecs.dll