IWICBitmapEncoder::Commit 方法 (wincodec.h)
認可映像的所有變更,並關閉數據流。
Syntax
HRESULT Commit();
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
若要完成影像,必須 呼叫畫面認可 和編碼器 認可 。 不過,只有在認可所有畫面之後,才呼叫編碼器 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 |
程式庫 | Windowscodecs.lib |
Dll | Windowscodecs.dll |