Fungsi SetThreadGroupAffinity (processtopologyapi.h)
Mengatur afinitas grup prosesor untuk utas yang ditentukan.
Sintaks
BOOL SetThreadGroupAffinity(
[in] HANDLE hThread,
[in] const GROUP_AFFINITY *GroupAffinity,
[out, optional] PGROUP_AFFINITY PreviousGroupAffinity
);
Parameter
[in] hThread
Handel ke utas.
Handel harus memiliki hak akses THREAD_SET_INFORMATION. Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.
[in] GroupAffinity
Struktur GROUP_AFFINITY yang menentukan afinitas grup prosesor yang akan digunakan untuk utas yang ditentukan.
[out, optional] PreviousGroupAffinity
Penunjuk ke struktur GROUP_AFFINITY untuk menerima afinitas grup alur sebelumnya. Parameter ini bisa NULL.
Mengembalikan nilai
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 SetThreadGroupAffinity membatasi afinitas utas ke prosesor melalui grup prosesor tunggal yang ditentukan oleh GroupAffinity yang diberikan. Grup ini juga akan menjadi 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 |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk