Fungsi WaitForThreadpoolIoCallbacks (threadpoolapiset.h)

Artikel
08/26/2023

Menunggu panggilan balik penyelesaian I/O yang luar biasa selesai dan secara opsional membatalkan panggilan balik yang tertunda yang belum mulai dijalankan.

Sintaks

void WaitForThreadpoolIoCallbacks(
  [in, out] PTP_IO pio,
  [in]      BOOL   fCancelPendingCallbacks
);

Parameter

[in, out] pio

Penunjuk ke struktur TP_IO yang menentukan objek penyelesaian I/O. Fungsi CreateThreadpoolIo mengembalikan penunjuk ini.

[in] fCancelPendingCallbacks

Menunjukkan apakah akan membatalkan panggilan balik antrean yang belum mulai dijalankan.

Mengembalikan nilai

Tidak ada

Keterangan

Ketika fCancelPendingCallbacks diatur ke TRUE, hanya panggilan balik yang diantrekan yang dibatalkan. Permintaan I/O yang tertunda tidak dibatalkan. Oleh karena itu, pemanggil harus memanggil GetOverlappedResult untuk struktur TUMPANG TINDIH untuk memeriksa apakah operasi I/O telah selesai sebelum membebaskan struktur. Sebagai alternatif, atur fCancelPendingCallbacks ke FALSE dan minta panggilan balik penyelesaian I/O terkait membebaskan struktur TUMPANG TINDIH . Berhati-hatilah untuk tidak membebaskan struktur YANG TUMPANG TINDIH saat permintaan I/O masih tertunda; gunakan GetOverlappedResult untuk menentukan status operasi I/O dan tunggu hingga operasi selesai. Fungsi CancelIoEx secara opsional dapat digunakan terlebih dahulu untuk membatalkan permintaan I/O yang beredar, berpotensi mempersingkat waktu tunggu. Untuk informasi selengkapnya, lihat Membatalkan Operasi I/O Yang Tertunda.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau lebih tinggi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	threadpoolapiset.h (termasuk Windows.h pada Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll