Fungsi GetThreadGroupAffinity (processtopologyapi.h)
Mengambil afinitas grup prosesor dari utas yang ditentukan.
Sintaks
BOOL GetThreadGroupAffinity(
[in] HANDLE hThread,
[out] PGROUP_AFFINITY GroupAffinity
);
Parameter
[in] hThread
Handel ke utas yang afinitas grup prosesornya diinginkan.
Handel harus memiliki hak akses THREAD_QUERY_INFORMATION atau THREAD_QUERY_LIMITED_INFORMATION. Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.
[out] GroupAffinity
Penunjuk ke struktur GROUP_AFFINITY untuk menerima afinitas grup utas.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, gunakan GetLastError.
Keterangan
Dimulai dengan Windows 11 dan Windows Server 2022, pada sistem dengan lebih dari 64 prosesor, proses dan afinitas utas mencakup semua prosesor dalam sistem, di semua grup prosesor, secara default. Fungsi GetThreadGroupAffinity mengambil afinitas grup melalui grup utama utas.
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, atur _WIN32_WINNT >= 0x0601. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | processtopologyapi.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |