Функция 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 |