Fungsi StartThreadpoolIo (threadpoolapiset.h)
Memberi tahu kumpulan utas bahwa operasi I/O mungkin dimulai untuk objek penyelesaian I/O yang ditentukan. Utas pekerja memanggil fungsi panggilan balik objek penyelesaian I/O setelah operasi selesai pada handel file yang terikat ke objek ini.
Sintaks
void StartThreadpoolIo(
[in, out] PTP_IO pio
);
Parameter
[in, out] pio
Penunjuk ke struktur TP_IO yang menentukan objek penyelesaian I/O. Fungsi CreateThreadpoolIo mengembalikan penunjuk ini.
Mengembalikan nilai
Tidak ada
Keterangan
Anda harus memanggil fungsi ini sebelum memulai setiap operasi I/O asinkron pada handel file yang terikat ke objek penyelesaian I/O. Kegagalan untuk melakukannya akan menyebabkan kumpulan utas mengabaikan operasi I/O ketika selesai dan akan menyebabkan kerusakan memori.
Jika operasi I/O gagal, panggil fungsi CancelThreadpoolIo untuk membatalkan pemberitahuan ini.
Jika handel file yang terikat ke objek penyelesaian I/O memiliki mode pemberitahuan FILE_SKIP_COMPLETION_PORT_ON_SUCCESS dan operasi I/O asinkron segera kembali dengan sukses, fungsi panggilan balik penyelesaian I/O objek tidak dipanggil dan pemberitahuan I/O threadpool harus dibatalkan. Untuk informasi selengkapnya, lihat CancelThreadpoolIo.
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 |