GetSystemCpuSetInformation 函式

允許應用程式查詢系統上可用的 CPU 集合及其目前狀態。

語法

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

參數

資訊 [out， 選擇性]

接收 CPU 集合資料 之SYSTEM_CPU_SET_INFORMATION 結構的指標。 傳遞具有緩衝區長度為 0 的 Null，以判斷所需的緩衝區大小。

BufferLength [in]

傳遞為 Information 引數之輸出緩衝區的長度，以位元組為單位。

ReturnedLength [out]

如果緩衝區夠大，或輸出緩衝區所需的大小，則輸出緩衝區中有效資料的長度，以位元組為單位。 如果沒有 CPU 集合存在，這個值將會是 0。

進程 [in， 選擇性]

進程的選擇性控制碼。 此程式可用來判斷SYSTEM_CPU_SET_INFORMATION結構中 AllocatedToTargetProcess 旗標的值。 如果 CPU 集合配置給指定的進程，則會設定 旗標。 否則，就清楚了。 此控制碼必須具有PROCESS_QUERY_LIMITED_INFORMATION存取權限。 您也可以在這裡指定 GetCurrentProcess 傳回的值。

旗標

保留的 必須是 0。

傳回值

如果 API 成功，則會傳回 TRUE。 如果失敗，可透過 GetLastError取得錯誤原因。 如果資訊緩衝區為 Null 或不夠大，則會傳回錯誤碼ERROR_INSUFFICIENT_BUFFER。 當傳遞的有效參數和足以保存所有傳回資料的緩衝區時，此 API 無法失敗。

規格需求

需求	值
最低支援的用戶端	Windows 10 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2016 [傳統型應用程式 |UWP 應用程式]
標頭	Processthreadsapi.h
程式庫	Windows.h
DLL	Kernel32.dll