Fungsi GetProcessGroupAffinity (processtopologyapi.h)
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
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