Metode IWICBitmapCodecProgressNotification::RegisterProgressNotification (wincodec.h)
Mendaftarkan fungsi panggilan balik pemberitahuan kemajuan.
Sintaks
HRESULT RegisterProgressNotification(
[in] PFNProgressNotification pfnProgressNotification,
[in] LPVOID pvData,
[in] DWORD dwProgressFlags
);
Parameter
[in] pfnProgressNotification
Jenis: PFNProgressNotification
Penunjuk fungsi ke fungsi panggilan balik pemberitahuan kemajuan yang ditentukan aplikasi. Lihat ProgressNotificationCallback untuk tanda tangan panggilan balik.
[in] pvData
Jenis: LPVOID
Penunjuk ke data komponen untuk metode panggilan balik.
[in] dwProgressFlags
Jenis: DWORD
Bendera WICProgressOperation dan WICProgressNotification digunakan untuk pemberitahuan kemajuan.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Aplikasi hanya dapat mendaftarkan satu panggilan balik. Panggilan pendaftaran berikutnya akan menggantikan panggilan balik yang terdaftar sebelumnya. Untuk membatalkan pendaftaran panggilan balik, lewati NULL atau daftarkan fungsi panggilan balik baru.
Kemajuan dilaporkan dalam urutan yang meningkat antara 0,0 dan 1,0. Jika dwProgressFlags menyertakan WICProgressNotificationBegin, panggilan balik dijamin akan dipanggil dengan kemajuan 0.0. Jika dwProgressFlags menyertakan WICProgressNotificationEnd, panggilan balik dijamin akan dipanggil dengan kemajuan 1.0.
WICProgressNotificationFrequent meningkatkan frekuensi panggilan balik dipanggil. Jika operasi diperkirakan membutuhkan waktu lebih dari 30 detik, WICProgressNotificationFrequent harus ditambahkan ke dwProgressFlags.
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 |