Fungsi CreateUmsCompletionList (winbase.h)
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 |
---|---|
|
Tidak tersedia cukup memori untuk membuat daftar penyelesaian. |
|
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) |