Menginisialisasi dan Mengakhiri Konteks Panggilan Balik

Sebelum rutinitas panggilan balik antrean default dapat digunakan, baik dengan menentukannya sebagai rutinitas panggilan balik saat melakukan antrean file, atau dengan memanggilnya dari rutinitas panggilan balik kustom, itu harus diinisialisasi.

FungsiSetupInitDefaultQueueCallbackmembangun struktur konteks yang digunakan oleh rutinitas panggilan balik antrean default. Ini mengembalikan penunjuk kekosongan ke struktur tersebut. Struktur ini sangat penting untuk operasi rutin panggilan balik default dan harus diteruskan ke rutinitas panggilan balik. Anda dapat melakukannya dengan menentukan pointer void sebagai konteks dalam panggilan ke SetupCommitFileQueue, atau dengan menentukan pointer void sebagai parameter konteks saat memanggil SetupDefaultQueueCallback dari rutinitas panggilan balik kustom. Struktur konteks ini tidak boleh diubah atau direferensikan oleh aplikasi penyiapan.

FungsiSetupInitDefaultQueueCallbackExjuga menginisialisasi konteks untuk rutinitas panggilan balik antrean default, tetapi menentukan jendela kedua untuk menerima pesan kemajuan yang ditentukan pemanggil setiap kali antrean mengirim pemberitahuan. Ini memungkinkan Anda menggunakan kotak dialog permintaan dan kesalahan disk default, dan juga menyematkan bilah kemajuan di jendela kedua, misalnya, di halaman wizard penginstalan.

Terlepas dari apakah Anda menginisialisasi konteks yang digunakan oleh rutinitas panggilan balik antrean default dengan SetupInitDefaultQueueCallback atau SetupInitDefaultQueueCallbackEx, setelah operasi antrean selesai diproses, panggil SetupTermDefaultQueueCallback untuk merilis sumber daya yang dialokasikan dalam menginisialisasi struktur konteks.