Fungsi ConvertThreadToFiber (winbase.h)

Artikel
03/09/2024

Mengonversi utas saat ini menjadi serat. Anda harus mengonversi utas menjadi serat sebelum Anda dapat menjadwalkan serat lainnya.

Sintaks

LPVOID ConvertThreadToFiber(
  [in, optional] LPVOID lpParameter
);

Parameter

[in, optional] lpParameter

Penunjuk ke variabel yang diteruskan ke serat. Serat dapat mengambil data ini dengan menggunakan makro GetFiberData .

Nilai kembali

Jika fungsi berhasil, nilai pengembalian adalah alamat serat.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Hanya serat yang dapat mengeksekusi serat lainnya. Jika utas perlu menjalankan serat, utas harus memanggil ConvertThreadToFiber atau ConvertThreadToFiberEx untuk membuat area untuk menyimpan informasi status serat. Utas sekarang menjadi serat saat ini. Informasi status untuk serat ini mencakup data serat yang ditentukan oleh lpParameter.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0400 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Contoh

Misalnya, lihat Menggunakan Fiber.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll