Fungsi GetProcessDefaultCpuSetMasks (processthreadsapi.h)
Mengambil daftar Set CPU dalam set default proses yang ditetapkan oleh SetProcessDefaultCpuSetMasks atau SetProcessDefaultCpuSets.
Sintaks
BOOL GetProcessDefaultCpuSetMasks(
HANDLE Process,
PGROUP_AFFINITY CpuSetMasks,
USHORT CpuSetMaskCount,
PUSHORT RequiredMaskCount
);
Parameter
Process
Menentukan handel proses untuk proses yang akan dikueri. Handel ini harus memiliki hak akses PROCESS_QUERY_LIMITED_INFORMATION . Nilai yang dikembalikan oleh GetCurrentProcess juga dapat ditentukan di sini.
CpuSetMasks
Menentukan buffer opsional untuk mengambil daftar struktur GROUP_AFFINITY yang mewakili Proses Set CPU default.
CpuSetMaskCount
Menentukan ukuran array CpuSetMasks , dalam elemen.
RequiredMaskCount
Pada pengembalian yang berhasil, menentukan jumlah struktur afinitas yang ditulis ke array. Jika array CpuSetMasks terlalu kecil, fungsi gagal dengan ERROR_INSUFFICIENT_BUFFER dan mengatur parameter RequiredMaskCount ke jumlah elemen yang diperlukan. Jumlah elemen yang diperlukan selalu kurang dari atau sama dengan jumlah grup maksimum yang dikembalikan oleh GetMaximumProcessorGroupCount.
Menampilkan nilai
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.
Jika array yang disediakan terlalu kecil, nilai kesalahan ERROR_INSUFFICIENT_BUFFER dan RequiredMaskCount diatur ke jumlah elemen yang diperlukan.
Keterangan
Jika tidak ada Set CPU default yang diatur untuk proses tertentu, parameter RequiredMaskCount diatur ke 0 dan fungsi berhasil.
Fungsi ini dianalogikan dengan GetProcessDefaultCpuSets, kecuali bahwa fungsi ini menggunakan afinitas grup dibandingkan dengan ID Set CPU untuk mewakili daftar set CPU. Ini berarti bahwa Proses Set CPU default dipetakan ke prosesor rumah mereka, dan prosesor tersebut diambil dalam daftar afinitas grup yang dihasilkan.
Persyaratan
Klien minimum yang didukung | Windows 11 |
Server minimum yang didukung | Windows Server 2022 |
Header | processthreadsapi.h |
DLL | kernel32.dll |