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

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

  • Статья

Извлекает список наборов ЦП в наборе по умолчанию процесса, заданном SetProcessDefaultCpuSetMasks или SetProcessDefaultCpuSets.

Синтаксис

BOOL GetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Параметры

Process

Указывает дескриптор процесса для запроса. Этот дескриптор должен иметь право доступа PROCESS_QUERY_LIMITED_INFORMATION . Здесь также можно указать значение, возвращаемое Методом GetCurrentProcess .

CpuSetMasks

Указывает необязательный буфер для получения списка GROUP_AFFINITY структур, представляющих наборы ЦП процесса по умолчанию.

CpuSetMaskCount

Задает размер массива CpuSetMasks в элементах .

RequiredMaskCount

При успешном возвращении указывает количество сходства структур, записанных в массив. Если массив CpuSetMasks слишком мал, функция завершается сбоем с ERROR_INSUFFICIENT_BUFFER и задает для параметра RequiredMaskCount необходимое количество элементов. Количество обязательных элементов всегда меньше или равно максимальному числу групп, возвращаемого командлетом GetMaximumProcessorGroupCount.

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция завершается сбоем, возвращаемое значение равно нулю, а расширенные сведения об ошибке можно получить, вызвав Метод GetLastError.

Если предоставленный массив слишком мал, значение ошибки ERROR_INSUFFICIENT_BUFFER а параметру RequiredMaskCount присваивается необходимое количество элементов.

Комментарии

Если наборы ЦП по умолчанию для определенного процесса не заданы, параметр RequiredMaskCount имеет значение 0, и функция будет выполнена успешно.

Эта функция аналогична GetProcessDefaultCpuSets, за исключением того, что в ней используются сходства групп, а не идентификаторы наборов ЦП для представления списка наборов ЦП. Это означает, что наборы ЦП процесса по умолчанию сопоставляются с их домашними процессорами, и эти процессоры извлекаются в результирующем списке сходств групп.

Требования

   
Минимальная версия клиента Windows 11
Минимальная версия сервера Windows Server 2022
Верхняя часть processthreadsapi.h
DLL kernel32.dll