Fungsi SetThreadSelectedCpuSetMasks (processthreadsapi.h)

Artikel
03/01/2024

Mengatur penetapan Set CPU yang dipilih untuk utas yang ditentukan. Penugasan ini mengambil alih penugasan default proses, jika penugasan ditetapkan.

Sintaks

BOOL SetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount
);

Parameter

Thread

Menentukan utas untuk mengatur penetapan Set CPU. PROCESS_SET_LIMITED_INFORMATION akses ke kanan. Nilai yang dikembalikan oleh GetCurrentProcess juga dapat ditentukan di sini.

CpuSetMasks

Menentukan buffer opsional struktur GROUP_AFFINITY yang mewakili Set CPU untuk diatur sebagai rangkaian kumpulan CPU yang dipilih. Jika ini ADALAH NULL, fungsi SetThreadSelectedCpuSetMasks menghapus penugasan apa pun, kembali untuk memproses penetapan default jika ditetapkan.

CpuSetMaskCount

Menentukan jumlah struktur GROUP_AFFINITY dalam daftar yang diteruskan dalam argumen GroupCpuSets. Jika buffer NULL, nilai ini harus nol.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol dan informasi kesalahan yang diperluas dapat diambil dengan memanggil GetLastError.

Keterangan

Fungsi ini dianalogikan dengan SetThreadSelectedCpuSets, kecuali bahwa fungsi ini menggunakan afinitas grup dibandingkan dengan ID Set CPU untuk mewakili daftar set CPU. Ini berarti bahwa penetapan Rangkaian CPU yang dipilih yang dihasilkan adalah kumpulan semua set CPU dengan prosesor rumah dalam daftar afinitas grup yang disediakan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11
Server minimum yang didukung	Windows Server 2022
Header	processthreadsapi.h
DLL	kernel32.dll

Bagikan melalui