Fungsi CreateThreadpoolIo (threadpoolapiset.h)
Membuat objek penyelesaian I/O baru.
Sintaks
PTP_IO CreateThreadpoolIo(
[in] HANDLE fl,
[in] PTP_WIN32_IO_CALLBACK pfnio,
[in, out, optional] PVOID pv,
[in, optional] PTP_CALLBACK_ENVIRON pcbe
);
Parameter
[in] fl
Handel file untuk mengikat objek penyelesaian I/O ini.
[in] pfnio
Fungsi panggilan balik yang akan dipanggil setiap kali operasi I/O yang tumpang tindih selesai pada file. Untuk detailnya, lihat IoCompletionCallback.
[in, out, optional] pv
Data opsional yang ditentukan aplikasi untuk diteruskan ke fungsi panggilan balik.
[in, optional] pcbe
Penunjuk ke struktur TP_CALLBACK_ENVIRON yang menentukan lingkungan untuk menjalankan panggilan balik. Gunakan fungsi InitializeThreadpoolEnvironment untuk menginisialisasi struktur sebelum memanggil fungsi ini.
Jika parameter ini NULL, panggilan balik dijalankan di lingkungan panggilan balik default. Untuk informasi selengkapnya, lihat InitializeThreadpoolEnvironment.
Nilai kembali
Jika fungsi berhasil, fungsi mengembalikan penunjuk ke struktur TP_IO yang menentukan objek I/O. Aplikasi tidak mengubah anggota struktur ini.
Jika fungsi gagal, fungsi akan mengembalikan NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.
Keterangan
Untuk mulai menerima panggilan balik penyelesaian I/O yang tumpang tindih, panggil fungsi StartThreadpoolIo .
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 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 |