Fungsi GetProcessDefaultCpuSetMasks (processthreadsapi.h)

Artikel
08/25/2023

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

Bagikan melalui