共用方式為

GetSystemCpuSetInformation 函式 (processthreadsapi.h)

  • 發行項

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

語法

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

參數

Information

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

BufferLength

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

ReturnedLength

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

Process

進程的選擇性句柄。 此程式可用來判斷 SYSTEM_CPU_SET_INFORMATION 結構中的 AllocatedToTargetProcess 旗標值。 如果 CPU 集合設定給指定的進程，則會設定 旗標。 否則，就清楚了。 此句柄必須具有PROCESS_QUERY_LIMITED_INFORMATION訪問許可權。 GetCurrentProcess 傳回的值也可以在這裡指定。

Flags

保留的 必須是 0。

傳回值

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

規格需求

需求 值
最低支援的用戶端 Windows 10
最低支援的伺服器 WIndows Server 2016
標頭 processthreadsapi.h