Fungsi GetUmsSystemThreadInformation (winbase.h)

Artikel
02/01/2024

Mengkueri apakah utas yang ditentukan adalah utas penjadwal UMS, utas pekerja UMS, atau utas non-UMS.

Peringatan

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

Sintaks

BOOL GetUmsSystemThreadInformation(
  [in]      HANDLE                         ThreadHandle,
  [in, out] PUMS_SYSTEM_THREAD_INFORMATION SystemThreadInfo
);

Parameter

[in] ThreadHandle

Handel ke utas. Handel utas harus memiliki akses THREAD_QUERY_INFORMATION yang tepat. Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.

[in, out] SystemThreadInfo

Penunjuk ke struktur UMS_SYSTEM_THREAD_INFORMATION yang menerima informasi tentang utas yang ditentukan.

Penelepon harus menginisialisasi UmsVersion anggota sebelum memanggil.

Mengembalikan nilai

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi GetUmsSystemThreadInformation ditujukan untuk digunakan dalam debugger, alat pemecahan masalah, dan aplikasi pembuatan profil. Misalnya, pelacakan terisolasi utas atau satu langkah melalui instruksi mungkin melibatkan penangguhan semua utas lain dalam proses. Namun, jika utas yang akan dilacak adalah utas pekerja UMS, menangguhkan utas penjadwal UMS dapat menyebabkan kebuntuan karena utas pekerja UMS memerlukan intervensi utas penjadwal UMS untuk berjalan. Debugger dapat memanggil GetUmsSystemThreadInformation untuk setiap utas yang mungkin ditangguhkan untuk menentukan jenis utas, lalu menangguhkannya atau tidak sesuai kebutuhan untuk kode yang di-debug.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 dengan SP1 [khusus aplikasi desktop], Windows 7 (hanya 64-bit) dan Windows Server 2008 R2 dengan KB977165 terinstal
Server minimum yang didukung	Windows Server 2008 R2 dengan SP1 [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)

Bagikan melalui