IWICBitmapEncoder::CreateNewFrame method (wincodec.h)

Artikel
03/03/2024

Membuat instans IWICBitmapFrameEncode baru.

Sintaks

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

Parameter

[out] ppIFrameEncode

Jenis: IWICBitmapFrameEncode**

Pointer yang menerima pointer ke instans baru IWICBitmapFrameEncode.

[in, out] ppIEncoderOptions

Jenis: IPropertyBag2**

Pilihan. Menerima properti bernama untuk digunakan untuk inisialisasi bingkai berikutnya. Lihat Keterangan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Parameter ppIEncoderOptions dapat digunakan untuk menerima IPropertyBag2 yang kemudian dapat digunakan untuk menentukan opsi encoder. Ini dilakukan dengan meneruskan pointer ke pointer NULL IPropertyBag2 di ppIEncoderOptions. IPropertyBag2 yang dikembalikan diinisialisasi dengan semua opsi encoder yang tersedia untuk format tertentu, pada nilai defaultnya. Untuk menentukan perilaku pengodean non-default, atur opsi encoder yang diperlukan pada IPropertyBag2 dan teruskan ke IWICBitmapFrameEncode::Initialize.

Catatan Jangan meneruskan penunjuk ke IPropertyBag2 yang diinisialisasi. Pointer akan ditimpa, dan IPropertyBag2 asli tidak akan dibebaskan.

Jika tidak, Anda dapat meneruskan NULL di ppIEncoderOptions jika Anda tidak berniat menentukan opsi encoder.

Lihat Gambaran Umum Pengodean untuk contoh cara mengatur opsi encoder.

Untuk format yang mendukung pengodean beberapa bingkai (misalnya, TIFF, JPEG-XR), Anda hanya dapat mengerjakan satu bingkai dalam satu waktu. Ini berarti Anda harus memanggil IWICBitmapFrameEncode::Commit sebelum Anda memanggil CreateNewFrame lagi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincodec.h
Pustaka	Windowscodecs.lib
DLL	Windowscodecs.dll

Lihat juga

Gambaran Umum Pengodean

IPropertyBag2

IWICBitmapEncoder