IWICBitmapEncoder::CreateNewFrame method (wincodec.h)
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.
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 |