Fungsi UmsThreadYield (winbase.h)

  • Artikel

Menghasilkan kontrol ke utas penjadwal mode pengguna (UMS) tempat utas pekerja UMS panggilan berjalan.

Peringatan

Pada Windows 11, penjadwalan mode pengguna tidak didukung. Semua panggilan gagal dengan kesalahan ERROR_NOT_SUPPORTED.

Sintaks

BOOL UmsThreadYield(
  [in] PVOID SchedulerParam
);

Parameter

[in] SchedulerParam

Parameter untuk diteruskan ke fungsi UmsSchedulerProc utas penjadwal.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan nilai bukan nol.

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

Keterangan

Utas pekerja UMS memanggil fungsi UmsThreadYield untuk secara kooperatif menghasilkan kontrol ke utas penjadwal UMS tempat utas pekerja berjalan. Jika utas pekerja UMS tidak pernah memanggil UmsThreadYield, utas pekerja berjalan sampai diblokir atau dihentikan.

Ketika kontrol beralih ke utas penjadwal UMS, sistem memanggil fungsi titik masuk penjadwal terkait dengan alasan UmsSchedulerThreadYield dan parameter ScheduleParam yang ditentukan oleh utas pekerja dalam panggilan UmsThreadYield .

Penjadwal aplikasi bertanggung jawab untuk menjadwalkan ulang utas pekerja.

Persyaratan

   
Klien minimum yang didukung Windows 7 (hanya 64-bit) [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header winbase.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll
Set API api-ms-win-core-ums-l1-1-0 (diperkenalkan di Windows 7)

Lihat juga

UmsSchedulerProc