共用方式為

IWICBitmapEncoder：：CreateNewFrame 方法 (wincodec.h)

  • 發行項

建立新的 IWICBitmapFrameEncode 實例。

語法

HRESULT CreateNewFrame(
  [out]     IWICBitmapFrameEncode **ppIFrameEncode,
  [in, out] IPropertyBag2         **ppIEncoderOptions
);

參數

[out] ppIFrameEncode

類型： IWICBitmapFrameEncode**

接收 IWICBitmapFrameEncode 新實例指標的指標。

[in, out] ppIEncoderOptions

類型： IPropertyBag2**

選擇性。 接收用於後續畫面初始化的具名屬性。 請參閱＜備註＞。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

ppIEncoderOptions 參數可用來接收 IPropertyBag2，然後可用來指定編碼器選項。 這是藉由將指標傳遞至ppIEncoderOptions中的 NULL IPropertyBag2 指標來完成。 傳回的 IPropertyBag2 會以其預設值的所有編碼器選項初始化。 若要指定非預設編碼行為，請在 IPropertyBag2 上設定所需的編碼器選項，並將其傳遞至 IWICBitmapFrameEncode：：Initialize。

注意 請勿將指標傳入初始化的 IPropertyBag2。 將會覆寫指標，而且不會釋放原始的 IPropertyBag2。
 
否則，如果您不想指定編碼器選項，則可以在ppIEncoderOptions中傳遞NULL。

如需如何設定編碼器選項的範例，請參閱 編碼概觀 。

對於支援編碼多個畫面的格式 (例如 TIFF、JPEG-XR) ，您一次只能處理一個畫面。 這表示您必須先呼叫 IWICBitmapFrameEncode：：Commit ，才能再次呼叫 CreateNewFrame 。

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 wincodec.h
程式庫 Windowscodecs.lib
Dll Windowscodecs.dll

另請參閱

編碼概觀

IPropertyBag2

IWICBitmapEncoder