Fungsi CreateUmsCompletionList (winbase.h)

  • Artikel

Membuat daftar penyelesaian penjadwalan mode pengguna (UMS).

Peringatan

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

Sintaks

BOOL CreateUmsCompletionList(
  [out] PUMS_COMPLETION_LIST *UmsCompletionList
);

Parameter

[out] UmsCompletionList

Variabel PUMS_COMPLETION_LIST . Pada output, parameter ini menerima penunjuk ke daftar penyelesaian UMS kosong.

Menampilkan nilai

Jika fungsi berhasil, fungsi mengembalikan nilai bukan nol.

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

Menampilkan kode Deskripsi
ERROR_NOT_ENOUGH_MEMORY
 Tidak tersedia cukup memori untuk membuat daftar penyelesaian.
ERROR_NOT_SUPPORTED
 UMS tidak didukung.

Keterangan

Daftar penyelesaian dikaitkan dengan utas penjadwal UMS saat fungsi EnterUmsSchedulingMode dipanggil untuk membuat utas penjadwal. Sistem mengantre utas pekerja UMS yang baru dibuat ke daftar penyelesaian. Ini juga mengantre utas pekerja UMS yang sebelumnya diblokir ke daftar penyelesaian ketika utas tidak lagi diblokir.

Ketika fungsi titik entri UmsSchedulerProc aplikasi dipanggil, penjadwal aplikasi harus mengambil item dari daftar penyelesaian dengan memanggil DequeueUmsCompletionListItems.

Setiap daftar penyelesaian memiliki peristiwa daftar penyelesaian terkait yang disinyalkan setiap kali sistem mengantre item ke daftar kosong. Gunakan GetUmsCompletionListEvent untuk mendapatkan handel ke peristiwa untuk daftar penyelesaian yang ditentukan.

Saat daftar penyelesaian tidak lagi diperlukan, gunakan DeleteUmsCompletionList untuk merilis daftar. Daftar harus kosong sebelum dapat dirilis.

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

DequeueUmsCompletionListItems

EnterUmsSchedulingMode

GetUmsCompletionListEvent