Fungsi GetSystemCpuSetInformation (processthreadsapi.h)

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

Sintaks

BOOL GetSystemCpuSetInformation(
  PSYSTEM_CPU_SET_INFORMATION Information,
  ULONG                       BufferLength,
  PULONG                      ReturnedLength,
  HANDLE                      Process,
  ULONG                       Flags
);

Parameter

Information

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

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

ReturnedLength

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.

Process

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.

Flags

Dicadangkan, harus 0.

Mengembalikan 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
Server minimum yang didukung	WIndows Server 2016
Header	processthreadsapi.h