Metode IWICBitmapCodecProgressNotification::RegisterProgressNotification (wincodec.h)

  • Artikel

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

Lihat juga

IWICBitmapCodecProgressNotification

ProgressNotificationCallback