Fungsi CreateUmsThreadContext (winbase.h)

Artikel
08/27/2023

Membuat konteks utas penjadwalan mode pengguna (UMS) untuk mewakili utas pekerja UMS.

Peringatan

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

Sintaks

BOOL CreateUmsThreadContext(
  [out] PUMS_CONTEXT *lpUmsThread
);

Parameter

[out] lpUmsThread

Variabel PUMS_CONTEXT. Pada output, parameter ini menerima penunjuk ke konteks utas UMS.

Mengembalikan 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 konteks utas UMS.

Keterangan

Konteks utas UMS mewakili status utas pekerja UMS. Konteks utas digunakan untuk menentukan utas pekerja UMS dalam panggilan fungsi.

Utas pekerja UMS dibuat dengan memanggil fungsi CreateRemoteThreadEx setelah menggunakan InitializeProcThreadAttributeList dan UpdateProcThreadAttribute untuk menyiapkan daftar atribut UMS untuk utas.

Struktur yang mendasar untuk konteks utas UMS dikelola oleh sistem dan tidak boleh dimodifikasi secara langsung. Untuk mendapatkan dan mengatur informasi tentang utas pekerja UMS, gunakan fungsi QueryUmsThreadInformation dan SetUmsThreadInformation .

Setelah utas pekerja UMS berakhir, konteks utasnya harus dirilis dengan memanggil DeleteUmsThreadContext.

Persyaratan

Persyaratan	Nilai
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)