Функция GetSystemCpuSetInformation

Статья
06/13/2023

Позволяет приложению запрашивать доступные наборы ЦП в системе и их текущее состояние.

Синтаксис

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

Параметры

Сведения [out, optional]: Указатель на структуру SYSTEM_CPU_SET_INFORMATION , получающую данные набора ЦП. Передайте значение NULL с длиной буфера 0, чтобы определить требуемый размер буфера.
BufferLength [in]: Длина (в байтах) выходного буфера, передаваемого в качестве аргумента Information.
ReturnedLength [out]: Длина допустимых данных в байтах в выходном буфере, если буфер достаточно велик, или требуемый размер выходного буфера. Если наборов ЦП не существует, это значение будет равно 0.
Обработка [в, необязательно]: Необязательный дескриптор процесса. Этот процесс используется для определения значения флага AllocatedToTargetProcess в структуре SYSTEM_CPU_SET_INFORMATION. Если для указанного процесса выделен набор ЦП, устанавливается флаг . В противном случае ясно. Этот дескриптор должен иметь право доступа PROCESS_QUERY_LIMITED_INFORMATION. Здесь также можно указать значение, возвращаемое Методом GetCurrentProcess .
Flags: Зарезервировано, должно быть 0.

Возвращаемое значение

Если API успешно выполняется, возвращается значение TRUE. В случае сбоя причина ошибки доступна в getLastError. Если буфер сведений имеет значение NULL или недостаточно большой, возвращается код ошибки ERROR_INSUFFICIENT_BUFFER. Этот API не может завершиться ошибкой при передаче допустимых параметров и буфере, достаточном для хранения всех возвращаемых данных.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2016 [классические приложения \| Приложения UWP]
Заголовок	Processthreadsapi.h
Библиотека	Windows.h
DLL	Kernel32.dll

Поделиться через