Fungsi SetThreadGroupAffinity (processtopologyapi.h)

  • Artikel

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

GROUP_AFFINITY