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


Функция GetSystemCpuSetInformation (processthreadsapi.h)

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

Синтаксис

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

Параметры

Information

Указатель на структуру SYSTEM_CPU_SET_INFORMATION , получающую данные набора ЦП. Передайте значение NULL с длиной буфера 0, чтобы определить требуемый размер буфера.

BufferLength

Длина (в байтах) выходного буфера, передаваемого в качестве аргумента Information.

ReturnedLength

Длина допустимых данных в байтах в выходном буфере, если буфер достаточно велик, или требуемый размер выходного буфера. Если наборов ЦП не существует, это значение будет равно 0.

Process

Необязательный дескриптор процесса. Этот процесс используется для определения значения флага AllocatedToTargetProcess в структуре SYSTEM_CPU_SET_INFORMATION. Если для указанного процесса выделен набор ЦП, устанавливается флаг . В противном случае ясно. Этот дескриптор должен иметь право доступа PROCESS_QUERY_LIMITED_INFORMATION. Здесь также можно указать значение, возвращаемое Методом GetCurrentProcess .

Flags

Зарезервировано, должно быть 0.

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 10
Минимальная версия сервера WIndows Server 2016
Верхняя часть processthreadsapi.h