Fungsi GetProcessGroupAffinity (processtopologyapi.h)

  • Artikel

Mengambil afinitas grup prosesor dari proses yang ditentukan.

Sintaks

BOOL GetProcessGroupAffinity(
  [in]      HANDLE  hProcess,
  [in, out] PUSHORT GroupCount,
  [out]     PUSHORT GroupArray
);

Parameter

[in] hProcess

Handel untuk proses.

Handel ini harus memiliki hak akses PROCESS_QUERY_INFORMATION atau PROCESS_QUERY_LIMITED_INFORMATION. Untuk informasi selengkapnya, lihat Keamanan Proses dan Hak Akses.

[in, out] GroupCount

Pada input, menentukan jumlah elemen dalam array GroupArray . Pada output, menentukan jumlah grup prosesor yang ditulis ke array. Jika array terlalu kecil, fungsi gagal dengan ERROR_INSUFFICIENT_BUFFER dan mengatur parameter GroupCount ke jumlah elemen yang diperlukan.

[out] GroupArray

Array nomor grup prosesor. Nomor grup disertakan dalam array jika utas dalam proses ditetapkan ke prosesor dalam grup.

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.

Jika nilai kesalahan ERROR_INSUFFICIENT_BUFFER, parameter GroupCount berisi ukuran buffer yang diperlukan dalam jumlah elemen.

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.

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 pada Windows Server 2008 Windows Server 2008 R2)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

GetThreadGroupAffinity

Grup Prosesor