Fungsi GetSystemCpuSetInformation

Memungkinkan aplikasi untuk mengkueri Set CPU yang tersedia pada sistem, dan statusnya saat ini.

Sintaks

BOOL WINAPI GetSystemCpuSetInformation(
  _Out_opt_  PSYSTEM_CPU_SET_INFORMATION  Information,
  _In_       ULONG                        BufferLength,
  _Out_      PULONG                       ReturnedLength,
  _In_opt_   HANDLE                       Process,
  _Reserved_ ULONG                        Flags
);

Parameter

Informasi [keluar, opsional]

Penunjuk ke struktur SYSTEM_CPU_SET_INFORMATION yang menerima data Kumpulan CPU. Teruskan NULL dengan panjang buffer 0 untuk menentukan ukuran buffer yang diperlukan.

BufferLength [in]

Panjangnya, dalam byte, dari buffer output yang diteruskan sebagai argumen Informasi.

ReturnedLength [out]

Panjangnya, dalam byte, dari data yang valid dalam buffer output jika buffer cukup besar, atau ukuran buffer output yang diperlukan. Jika tidak ada Set CPU, nilai ini akan menjadi 0.

Proses [in, opsional]

Handel opsional ke proses. Proses ini digunakan untuk menentukan nilai bendera AllocatedToTargetProcess dalam struktur SYSTEM_CPU_SET_INFORMATION. Jika Set CPU dialokasikan untuk proses yang ditentukan, bendera diatur. Jika tidak, itu jelas. Handel ini harus memiliki hak akses PROCESS_QUERY_LIMITED_INFORMATION. Nilai yang dikembalikan oleh GetCurrentProcess juga dapat ditentukan di sini.

Bendera

Dicadangkan, harus 0.

Menampilkan nilai

Jika API berhasil, API akan mengembalikan TRUE. Jika gagal, alasan kesalahan tersedia melalui GetLastError. Jika buffer Informasi NULL atau tidak cukup besar, kode kesalahan ERROR_INSUFFICIENT_BUFFER dikembalikan. API ini tidak dapat gagal ketika melewati parameter yang valid dan buffer yang cukup besar untuk menyimpan semua data yang dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2016 [aplikasi desktop | Aplikasi UWP]
Header	Processthreadsapi.h
Pustaka	Windows.h
DLL	Kernel32.dll